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"
}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.
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
Path Parameters
Id of the IPD admission to fetch (document id under ipd/{b-id}/admissions).
Response
OK — the requested IPD admission.
Admission document id.
Business id the admission belongs to.
Admission date-time as an ISO-8601 string.
Discharge date-time as an ISO-8601 string. Present once discharged.
Patient IPD case number.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The responsible doctor (id + name).
Show child attributes
Show child attributes
Coarse lifecycle stage of the admission.
IN, AD, DC Granular lifecycle status within the current stage.
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 Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Creation date-time as an ISO-8601 string.
Last-update date-time as an ISO-8601 string.
Show child attributes
Show child attributes
Total amount billed for the admission.
Total amount paid against the admission.
Map of custom attribute keys to arrays of string values.
Show child attributes
Show child attributes
Denormalized discharge-clearance state.
Show child attributes
Show child attributes
oid of the actor that last acted on the admission.
Was this page helpful?

