ABDM API — Doctor

Doctor endpoints are POST and authenticated (Authorization: Bearer <idToken>).

/create_doctor — POST (auth)

Creates a doctor (a Practitioner in the FHIR store + a MySQL user).

Request fields

Example request

{
  "user": {
    "email": "doctor@example.com",
    "firstName": "Umesh",
    "lastName": "Bilagi",
    "mobile": "9233235620"
  },
  "doctorPrintName": "Dr Umesh Bilagi",
  "medicalLicenseNumber": "KMC-12345",
  "specialty": "General Medicine",
  "qualification": "MBBS, MD",
  "gender": "Male"
}

Example response

{
  "name": "Dr Umesh Bilagi",
  "orgId": 1,
  "gcpFhirId": "cf4a6ab1-3f32-4b92-adc5-89489da6ca14",
  "qualification": "MBBS, MD",
  "ndhmProfessionalId": "",
  "registration": "",
  "gender": "Male",
  "speciality": "General Medicine",
  "type": "Practitioner",
  "userId": 12,
  "id": 12
}

Error codes

• VALIDATION_ERROR (400)
• INVALID_EMAIL_FORMAT (400) — backstop for malformed email.
• EMAIL_ALREADY_EXISTS (409) — email already registered.
• shared codes

/edit_doctor — POST (auth)

Updates an existing doctor's Practitioner resource.

Request fields

Example request

{
  "doctorGcpFhirId": "cf4a6ab1-3f32-4b92-adc5-89489da6ca14",
  "doctorPrintName": "Dr Umesh Bilagi",
  "medicalLicenseNumber": "KMC-12345",
  "specialty": "General Medicine",
  "qualification": "MBBS, MD",
  "gender": "Male"
}

Example response

{
  "mes": "successfully edited the doctor's information"
}

Error codes

• VALIDATION_ERROR (400)
• DOCTOR_NOT_FOUND (404) — doctorGcpFhirId does not exist in the FHIR store.
• shared codes

/get_doctor_opd_patients_by_date — POST (auth)

Lists a doctor's OPD patients for a given date. The doctor must be an active user.

Request fields

Example request

{
  "date": "2025-02-02",
  "doctorGcpId": "cf4a6ab1-3f32-4b92-adc5-89489da6ca14"
}

Example response

Returns an array of OPD registrations:

[
  {
    "token": "some-token-value",
    "opdId": 123,
    "orgId": 1,
    "date": "2025-02-02T00:00:00+05:30",
    "patientId": 456,
    "doctorId": 789,
    "prefix": "Mr",
    "firstName": "John",
    "middleName": "A.",
    "lastName": "Doe",
    "gender": "Male",
    "dob": "1990-01-01",
    "abhaAddress": "john@sbx",
    "abhaNumber": "ABHA1234567890",
    "mobile": "+911234567890",
    "status": "in-progress"
  }
]

Error codes

Shared codes only.

/get_doctor_ipd_patients_by_date — POST (auth)

Lists a doctor's IPD (in-patient) patients. The doctor must be an active user.

Request fields

Example request

{
  "doctorGcpId": "cf4a6ab1-3f32-4b92-adc5-89489da6ca14"
}

Example response

Returns an array of IPD patients:

[
  {
    "patientId": 131,
    "name": "Bhargav Chandrashekhar Hede",
    "gender": "male",
    "mobile": "8554901073",
    "doa": "2025-03-07T18:14:26.556Z",
    "doctors": [
      { "id": "cf4a6ab1-3f32-4b92-adc5-89489da6ca14", "name": "Dr U R Bilagi" }
    ],
    "dob": "1999-11-12",
    "ipNo": 65
  }
]

Error codes

Shared codes only.