Skip to main content
Use this endpoint to query lab reports across your tenant. Filter by patient, status, or date range and combine multiple filters in a single request. Results are paginated using cursor-based pagination. This endpoint queries FHIR DiagnosticReport resources stored on AWS HealthLake.

​
Request

​
patientId
string
Filter lab reports for a specific patient.
​
status
string
Filter by report status: registered, partial, preliminary, final, amended, corrected, appended, or cancelled.
​
dateFrom
string
Return reports with an effective date on or after this date (YYYY-MM-DD).
​
dateTo
string
Return reports with an effective date on or before this date (YYYY-MM-DD).
​
sort
string
Sort field. Prefix with - for descending order (e.g. -date for newest first).
​
count
integer
Number of results per page. Default 20, maximum 100.
​
cursor
string
Pagination cursor from the previous response’s cursor field.
curl "https://api.clinikapi.com/v1/labs?patientId=pt_abc123&status=final&sort=-date" \
  -H "x-api-key: clk_live_your_key"

​
Response

​
data
array
Array of lab report objects matching the search criteria.
​
total
integer
Total number of matching lab reports.
​
cursor
string
Cursor to pass as cursor in the next request. null when there are no more results.
​
hasMore
boolean
Whether additional pages of results exist.
Example response
{
  "data": {
    "data": [
      {
        "id": "lab_abc123",
        "patientId": "pt_abc123",
        "status": "final",
        "code": {
          "system": "http://loinc.org",
          "code": "24323-8",
          "display": "Comprehensive metabolic 2000 panel"
        },
        "category": "LAB",
        "effectiveDateTime": "2025-01-15T10:30:00Z",
        "conclusion": "All values within normal limits.",
        "createdAt": "2025-01-15T10:35:00Z"
      }
    ],
    "total": 1,
    "cursor": null,
    "hasMore": false
  },
  "meta": {
    "requestId": "req_v0w1x2y3",
    "timestamp": "2025-01-15T10:45:00Z",
    "status": 200
  }
}