Skip to main content
Use this endpoint to fetch the full details of a lab report. Pass include=Observation to embed the linked observation resources directly in the response, avoiding a separate round-trip to look up individual results.

​
Request

GET https://api.clinikapi.com/v1/labs/:id

​
Headers

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

​
Path parameters

​
id
string
required
The lab report ID to retrieve (e.g. lab_abc123).

​
Query parameters

​
include
string[]
Resource types to include inline. Pass Observation to embed linked observation results in the response.

​
Response

Returns 200 OK with the lab report resource wrapped in the standard envelope.
​
data.id
string
The lab report ID.
​
data.status
string
Report status: registered, partial, preliminary, final, amended, corrected, appended, or cancelled.
​
data.code
string | object
LOINC code identifying the report type.
​
data.patientId
string
Patient reference.
​
data.category
string
Report category: LAB, RAD, or PAT.
​
data.effectiveDateTime
string
Clinically relevant timestamp, if recorded.
​
data.resultIds
string[]
IDs of linked observation resources.
​
data.conclusion
string
Clinical conclusion text, if recorded.
​
data.conclusionCodes
array
Coded SNOMED findings, if recorded.
​
data.presentedForm
array
Attached documents, if recorded.
​
included
array
Embedded Observation resources, present when include=Observation is specified.
​
meta
object
Standard response metadata including requestId, timestamp, status, and rate-limit fields.

​
Examples

​
curl

# Basic read
curl https://api.clinikapi.com/v1/labs/lab_abc123 \
  -H "x-api-key: clk_live_abc123"

# Include linked observations
curl "https://api.clinikapi.com/v1/labs/lab_abc123?include=Observation" \
  -H "x-api-key: clk_live_abc123"

​
TypeScript SDK

import { Clinik } from '@clinikapi/sdk';

const clinik = new Clinik(process.env.CLINIKAPI_SECRET_KEY!);

// Read with included observations
const { data } = await clinik.labs.read('lab_abc123', {
  include: ['Observation'],
});

console.log(data.conclusion);
console.log(data.resultIds); // ['obs_glucose', 'obs_sodium', ...]