Retrieve a patient

GET
/patients/{id}

Authorization

BearerAuth
AuthorizationBearer <token>

Medblocks API key for server-side requests.

In: header

Path Parameters

id*string

Your patient_id from Patient creation or Session upsert.

Header Parameters

Version?string

Date-pinned API version. If omitted, Medblocks uses the version pinned on your API key.

Response Body

application/json

application/json

curl -X GET "https://example.com/patients/string" \  -H "Version: 2026-04-25"
{  "id": "user_42",  "resource_type": "patient",  "email": "jane@example.com",  "name": "Jane Doe",  "metadata": {    "plan": "premium"  },  "created_at": "2026-04-25T14:30:00.000Z",  "connections": [    {      "id": "conn_01J9YR9N3X4VZ6P2K5RH7M3LMP",      "resource_type": "connection",      "session_id": "sess_01J9YQ8M2X4VZ6P2K5RH7M3KQT",      "connection_id": "fhirsrc_02Zh2bnvRoWQJYgOAkI0Twcc",      "status": "active",      "scopes": [        "patient/*.read",        "offline_access"      ],      "failure_code": null,      "failure_at": null,      "created_at": "2026-04-25T14:35:00.000Z",      "updated_at": "2026-04-25T14:35:00.000Z"    }  ]}
{  "error": {    "type": "string",    "code": "string",    "message": "string",    "param": "string",    "doc_url": "http://example.com",    "request_id": "string"  }}
Non-2xx responses use the standard API error envelope. Log error.code and error.request_id for support.