Skip to main content
Use this endpoint to retrieve a list of clinical assessments matching your filter criteria. All query parameters are optional. Combine filters to narrow results — for example all completed assessments conducted by a specific practitioner since a given date.

​
Request

GET https://api.clinikapi.com/v1/assessments

​
Headers

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

​
Query parameters

​
patientId
string
Filter assessments to a specific patient (e.g. pt_abc123).
​
practitionerId
string
Filter by the practitioner who conducted the assessment (e.g. prac_def456).
​
encounterId
string
Filter by the associated encounter (e.g. enc_xyz789).
​
status
string
Filter by status. One of: in-progress, completed.
​
dateFrom
string
Return assessments with an effectiveDateTime on or after this value. Format: YYYY-MM-DD.
​
dateTo
string
Return assessments with an effectiveDateTime on or before this value. Format: YYYY-MM-DD.
​
sort
string
Sort order. Prefix with - for descending. Example: -date returns the most recent assessments first.
​
page
number
Page number for paginated results. Defaults to 1.
​
pageSize
number
Number of results per page. Defaults to 20. Maximum 100.

​
Response

Returns 200 OK with an array of assessments and pagination metadata.
​
data
array
Array of assessment objects matching the query. Each item contains the same fields as the single-assessment read endpoint.
​
meta.total
number
Total number of assessments matching the query across all pages.
​
meta.page
number
Current page number.
​
meta.pageSize
number
Number of results per page.
​
meta
object
Standard response metadata including requestId, timestamp, status, and rate-limit fields.

​
Examples

​
curl

# All completed assessments for a patient
curl "https://api.clinikapi.com/v1/assessments?patientId=pt_abc123&status=completed&sort=-date" \
  -H "x-api-key: clk_live_abc123"

​
TypeScript SDK

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

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

// All completed assessments for a patient
const { data } = await clinik.assessments.search({
  patientId: 'pt_abc123',
  status: 'completed',
  sort: '-date',
});

// Assessments by a specific practitioner since January 2025
const { data: byDoc } = await clinik.assessments.search({
  practitionerId: 'prac_def456',
  dateFrom: '2025-01-01',
});