Retrieve patient

Retrieves a single patient by unique identifier. Returns the full patient object including metadata and linked external IDs.

Last updated July 4, 2026

GET/v1/patients/{id}

Retrieve a patient when rendering a chart summary, verifying demographics before an appointment, or hydrating a detail view after search. Replace the {id} path parameter with a patient ID from create or list responses.

Path parameters

Name	Type	Required	Description
id	string	Yes	Unique patient identifier beginning with pat_.

GET/v1/patients/{id}Auth required

Fetches one patient by ID.

Name	In	Type	Required	Description
id	path	string	Yes	The patient ID, e.g. pat_8Kx2mN1qRt

Responsejson

{
  "id": "pat_8Kx2mN1qRt",
  "object": "patient",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane.doe@example.com",
  "appointments_count": 4,
  "metadata": { "mrn": "MRN-10482" }
}

cURLbash

curl https://api.vcaremd.com/v1/patients/pat_8Kx2mN1qRt \
  -H "Authorization: Bearer sk_test_YOUR_SECRET_KEY"

Errors

404 — patient not found or belongs to another organization.
401 — invalid API key.
403 — missing patients:read scope.

Was this page helpful?

Your feedback helps us improve our documentation.