Get Doctor¶

Retrieve the full profile for a single doctor by their ID.

Endpoint¶

GET /v1/doctor/{doctorId}

Path Parameters¶

Parameter	Type	Required	Description
`doctorId`	integer	Yes	Unique identifier of the doctor

Request¶

curl --location '{base_url}/v1/doctor/485195' \
  --header 'Authorization: Bearer JWT_TOKEN'

Response¶

Success Response¶

Code: 200 OK

{
  "code": 2000,
  "data": {
    "doctor_id": 485195,
    "first_name": "Matt",
    "middle_name": null,
    "last_name": "Swift",
    "name": "Matt Swift",
    "sex": "MALE",
    "photo_url": "https://us-phy-uploads.s3.us-west-2.amazonaws.com/files/example.png",
    "about": "Matt has been serving Orange County patients since 2006.",
    "qualifications": ["PT", "DPT"],
    "services": [],
    "sub_specializations": [],
    "master_specialization": "PHYSICAL_THERAPIST",
    "experiences": [],
    "specialities": [],
    "awards": null,
    "registration_number": "33345",
    "registration_body": null,
    "alternative_email": null,
    "languages": ["ENGLISH"],
    "years_of_experience": 0,
    "color_code": "#0a76db",
    "secondary_color": null,
    "text_color": null,
    "license": "33345",
    "npi": "1234567890",
    "roles": ["ADMIN", "DOCTOR"],
    "accomplishments": [],
    "hobbies": [],
    "clinics": [
      {
        "clinic_id": 44,
        "clinic_name": "Spry Clinic - Main",
        "status": "ACTIVE"
      }
    ],
    "doctor_rank": 0,
    "doctor_designation_details": "License # 33345 (Initiated by Matt Swift, PT, DPT)",
    "doctor_type": "HOME_DOCTOR",
    "is_cosign_required": false
  },
  "message": "Success"
}

Response Fields¶

Field	Type	Description
`doctor_id`	integer	Unique identifier for the doctor
`first_name`	string	Doctor's first name
`middle_name`	string	Doctor's middle name
`last_name`	string	Doctor's last name
`name`	string	Full name (first + middle + last)
`sex`	string	Gender (`MALE`, `FEMALE`, `OTHER`)
`photo_url`	string	URL to the doctor's profile photo
`about`	string	Bio / description
`qualifications`	array	Professional qualifications (e.g., `PT`, `DPT`)
`services`	array	Services offered
`sub_specializations`	array	Sub-specializations
`master_specialization`	string	Primary specialization (see Specialization Values)
`experiences`	array	Work experience entries
`specialities`	array	Medical specialties
`awards`	string	Awards and recognitions
`registration_number`	string	Professional registration number
`registration_body`	string	Registration authority
`alternative_email`	string	Alternate email address
`languages`	array	Languages spoken
`years_of_experience`	integer	Total years of experience
`color_code`	string	Primary UI color code
`secondary_color`	string	Secondary UI color code
`text_color`	string	Text UI color code
`license`	string	Medical license number
`npi`	string	National Provider Identifier
`roles`	array	System roles assigned
`accomplishments`	array	Accomplishments
`hobbies`	array	Hobbies and interests
`clinics`	array	Associated clinic details
`doctor_rank`	integer	Ranking within the system
`doctor_designation_details`	string	Full designation string
`doctor_type`	string	Doctor type (`HOME_DOCTOR`, `FLOATING_DOCTOR`, etc.)
`is_cosign_required`	boolean	Whether co-signing is required for this doctor

Error Response¶

Code: 400 Bad Request

{
  "code": 4000,
  "message": "Doctor not found",
  "data": null
}