V
Voxtar DevelopersAPI Reference / v1
Patientsv1

List Patients

Returns a paginated list of patients in your workspace, most recently created first. Filter by cohort metadata to pull an entire study group.

GETpatientscontent_copy

Headers

Authorization
RequiredBearer token — your secret API key. Create one in the dashboard under Developers → API Keys.

Query Parameters

limitintegerOptional

Page size, 1–100. Defaults to 20.

cursorstringOptional

Opaque cursor from a previous response's next_cursor.

cohortstringOptional

Optional. Filter to patients whose metadata.cohort matches this value.

Response

200 OKapplication/json
{
"data": [
{
"id": "pt_8kQ2v9",
"external_id": "subject-1042",
"baseline_status": "ready",
"last_analysis_at": "2026-07-10T18:02:00Z"
}
],
"next_cursor": "eyJvIjoyMH0",
"has_more": true
}