Get IPD Admission

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

import requests

url = "https://api.eka.care/appointments/v1/ipd/admission/{admission_id}"

headers = {"auth": "<auth>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {auth: '<auth>'}};

fetch('https://api.eka.care/appointments/v1/ipd/admission/{admission_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eka.care/appointments/v1/ipd/admission/{admission_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "auth: <auth>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eka.care/appointments/v1/ipd/admission/{admission_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("auth", "<auth>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.eka.care/appointments/v1/ipd/admission/{admission_id}")
  .header("auth", "<auth>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.eka.care/appointments/v1/ipd/admission/{admission_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["auth"] = '<auth>'

response = http.request(request)
puts response.read_body

{
  "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
  }
}

{
  "message": "unauthenticated"
}

{
  "message": "Admission \"adm-3f9c2b18\" was not found"
}

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>'

import requests

url = "https://api.eka.care/appointments/v1/ipd/admission/{admission_id}"

headers = {"auth": "<auth>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {auth: '<auth>'}};

fetch('https://api.eka.care/appointments/v1/ipd/admission/{admission_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eka.care/appointments/v1/ipd/admission/{admission_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "auth: <auth>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eka.care/appointments/v1/ipd/admission/{admission_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("auth", "<auth>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.eka.care/appointments/v1/ipd/admission/{admission_id}")
  .header("auth", "<auth>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.eka.care/appointments/v1/ipd/admission/{admission_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["auth"] = '<auth>'

response = http.request(request)
puts response.read_body

{
  "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
  }
}

{
  "message": "unauthenticated"
}

{
  "message": "Admission \"adm-3f9c2b18\" was not found"
}

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

Authorization

End-to-End Encryption

Connect

HealthAI

Medical Database

ABDM Connect

Doctor Tool

Medical Knowledge-bases

Medical Records

User App

Get IPD Admission

Overview

Headers

Path Parameters

Response