Get IPD Admission

curl --request GET \
  --url https://api.eka.care/appointments/v1/ipd/admission/{admission_id} \
  --header 'auth: <auth>'

{
  "id": "adm-3f9c2b18-7e44-4a51",
  "bid": "123456",
  "admission_date": "2026-06-28T09:30:00.000Z",
  "ipid": "IPD-2026-000481",
  "attendee": {
    "id": "att-01",
    "name": "Ramesh Kumar",
    "phone": {
      "c": "+91",
      "n": "9876543210"
    },
    "relation": {
      "id": "rel-son",
      "label": "Son"
    }
  },
  "patient": {
    "id": "pat-77",
    "uuid": "9c2d1b6f-0a8e-5d23-8b1a-2c3d4e5f6a7b",
    "poid": "poid-555",
    "formData": [],
    "profile": {
      "personal": {
        "gender": "M",
        "name": "Suresh Kumar"
      }
    }
  },
  "insurance": {
    "number": "POL-8891",
    "type": "Cashless",
    "payment_type": "Insurance",
    "insurance_provider": "Star Health",
    "pre_approved": true,
    "pre_approved_amount": 50000
  },
  "refer": {
    "id": "ref-01",
    "name": "Dr. Anita Rao"
  },
  "doc": {
    "id": "doctor-oid-456",
    "name": "Dr. Vivek Sharma"
  },
  "stage": "AD",
  "status": "UNDER_CARE",
  "duration": {
    "value": 3,
    "unit": "days"
  },
  "bed": "ICU-04",
  "rateplan": {
    "id": "rp-standard",
    "name": "Standard ICU",
    "inclusions": []
  },
  "docid": "doctor-oid-456",
  "category": {
    "id": "cat-icu",
    "name": "ICU"
  },
  "date": "2026-06-28",
  "department": {
    "id": "dept-med",
    "name": "General Medicine"
  },
  "pid": "pid-321",
  "created_at": "2026-06-28T09:30:00.000Z",
  "updated_at": "2026-07-01T14:12:00.000Z",
  "facility": {
    "id": "fac-01",
    "name": "Eka General Hospital"
  },
  "facilityid": "fac-01",
  "totalbilled": 125000,
  "totalpaid": 50000,
  "totalbilled_updated_at": "2026-07-01T14:12:00.000Z",
  "totalpaid_updated_at": "2026-06-30T11:00:00.000Z",
  "clearances_summary": {
    "statuses": {
      "billing": "PENDING",
      "pharmacy": "COMPLETED"
    },
    "completed_count": 1,
    "total": 2,
    "all_complete": false
  }
}

IPD API

Get IPD Admission

Overview

This API fetches a single IPD (In-Patient Department) admission by its id, scoped to the caller’s business (b-id). An admission document captures the full in-patient episode — the patient, their attendee, insurance, bed and rateplan, the responsible doctor/department/facility, billing totals, and the admission’s lifecycle state.

The admission’s lifecycle is tracked with two fields: a coarse stage (IN → Recommended Admission, AD → active Admission, DC → Discharged) and a granular status within that stage (for example ADMISSION_CONFIRMED, BED_ASSIGNED, UNDER_CARE, DISCHARGED).

The admission_id path param is the admission id. All timestamp fields are returned as ISO-8601 date-time strings.

GET

appointments

ipd

admission

{admission_id}

Get IPD Admission

curl --request GET \
  --url https://api.eka.care/appointments/v1/ipd/admission/{admission_id} \
  --header 'auth: <auth>'

{
  "id": "adm-3f9c2b18-7e44-4a51",
  "bid": "123456",
  "admission_date": "2026-06-28T09:30:00.000Z",
  "ipid": "IPD-2026-000481",
  "attendee": {
    "id": "att-01",
    "name": "Ramesh Kumar",
    "phone": {
      "c": "+91",
      "n": "9876543210"
    },
    "relation": {
      "id": "rel-son",
      "label": "Son"
    }
  },
  "patient": {
    "id": "pat-77",
    "uuid": "9c2d1b6f-0a8e-5d23-8b1a-2c3d4e5f6a7b",
    "poid": "poid-555",
    "formData": [],
    "profile": {
      "personal": {
        "gender": "M",
        "name": "Suresh Kumar"
      }
    }
  },
  "insurance": {
    "number": "POL-8891",
    "type": "Cashless",
    "payment_type": "Insurance",
    "insurance_provider": "Star Health",
    "pre_approved": true,
    "pre_approved_amount": 50000
  },
  "refer": {
    "id": "ref-01",
    "name": "Dr. Anita Rao"
  },
  "doc": {
    "id": "doctor-oid-456",
    "name": "Dr. Vivek Sharma"
  },
  "stage": "AD",
  "status": "UNDER_CARE",
  "duration": {
    "value": 3,
    "unit": "days"
  },
  "bed": "ICU-04",
  "rateplan": {
    "id": "rp-standard",
    "name": "Standard ICU",
    "inclusions": []
  },
  "docid": "doctor-oid-456",
  "category": {
    "id": "cat-icu",
    "name": "ICU"
  },
  "date": "2026-06-28",
  "department": {
    "id": "dept-med",
    "name": "General Medicine"
  },
  "pid": "pid-321",
  "created_at": "2026-06-28T09:30:00.000Z",
  "updated_at": "2026-07-01T14:12:00.000Z",
  "facility": {
    "id": "fac-01",
    "name": "Eka General Hospital"
  },
  "facilityid": "fac-01",
  "totalbilled": 125000,
  "totalpaid": 50000,
  "totalbilled_updated_at": "2026-07-01T14:12:00.000Z",
  "totalpaid_updated_at": "2026-06-30T11:00:00.000Z",
  "clearances_summary": {
    "statuses": {
      "billing": "PENDING",
      "pharmacy": "COMPLETED"
    },
    "completed_count": 1,
    "total": 2,
    "all_complete": false
  }
}

Headers

auth

string

required

Path Parameters

admission_id

string

required

Id of the IPD admission to fetch (document id under ipd/{b-id}/admissions).

Response

OK — the requested IPD admission.

string

Admission document id.

bid

string

Business id the admission belongs to.

admission_date

string

Admission date-time as an ISO-8601 string.

discharge_date

string

Discharge date-time as an ISO-8601 string. Present once discharged.

ipid

string

Patient IPD case number.

attendee

object

Show child attributes

patient

object

Show child attributes

insurance

object

Show child attributes

procedures

object[]

Show child attributes

refer

object

Show child attributes

doc

object

The responsible doctor (id + name).

Show child attributes

notes

string

medico_legal_case

boolean

stage

enum<string>

Coarse lifecycle stage of the admission.

Available options:

IN,

AD,

DC

status

enum<string>

Granular lifecycle status within the current stage.

Available options:

ADMISSION_RECOMMENDED,

ADMISSION_ON_HOLD,

ADMISSION_CONFIRMED,

ADMISSION_CANCELLED,

BED_ASSIGNED,

UNDER_CARE,

NOT_RECEIVED,

FIT_FOR_DISCHARGE,

DISCHARGE_INITIATED,

REFERRAL_INITIATED,

LAMA_IN_PROGRESS,

DAMA_IN_PROGRESS,

DEATH_BEING_RECORDED,

PATIENT_MISSING,

DISCHARGED,

LAMA_COMPLETED,

DAMA_COMPLETED,

REFERRED,

DECEASED,

ABSCONDED

duration

object

Show child attributes

bed

string

rateplan

object

Show child attributes

docid

string