Skip to main content
Use this endpoint to fetch a patient’s full record by their ID. You can optionally request related resources — such as encounters and observations — to be returned alongside the patient in a single response.

​
Request

GET https://api.clinikapi.com/v1/patients/{id}

​
Headers

​
x-api-key
string
required
Your ClinikAPI secret key (clk_live_* or clk_test_*).

​
Path Parameters

​
id
string
required
The patient ID to retrieve (e.g. pt_abc123).

​
Query Parameters

​
_revinclude
string[]
Include related resources in the response. Accepted values include Encounter:subject and Observation:subject. Pass this parameter multiple times to include multiple resource types.

​
Response

Returns 200 OK with the patient resource.
​
data.id
string
The patient’s unique ID.
​
data.firstName
string
Patient’s first name.
​
data.lastName
string
Patient’s last name.
​
data.email
string
Patient’s email address.
​
data.phone
string
Patient’s phone number.
​
data.gender
string
Patient’s gender (male, female, other, or unknown).
​
data.birthDate
string
Date of birth in YYYY-MM-DD format.
​
data.address
object
Patient’s address with line, city, state, postalCode, and country fields.
​
meta
object
Standard response metadata including requestId, timestamp, status, and rate-limit fields.

​
Examples

​
curl

curl https://api.clinikapi.com/v1/patients/pt_abc123 \
  -H "x-api-key: clk_live_abc123"

curl "https://api.clinikapi.com/v1/patients/pt_abc123?_revinclude=Encounter:subject&_revinclude=Observation:subject" \
  -H "x-api-key: clk_live_abc123"

​
TypeScript SDK

import { ClinikAPI } from "@clinikapi/sdk";

const client = new ClinikAPI({ apiKey: "clk_live_abc123" });

const patient = await client.patients.read("pt_abc123");
console.log(patient.data.firstName); // "Jane"

// With related resources
const patientWithRelated = await client.patients.read("pt_abc123", {
  _revinclude: ["Encounter:subject", "Observation:subject"],
});