# Patients (V1)

Patients endpoints

## Returns a list of patients (V1) based on filter criteria

 - [GET /v1/patients](https://papidocs.hs1api.com/publicapi/api-patient-management/patients-(v1)/getallpatients.md): Query shape: Prefer a narrow filter—combine name, chart, or contact filters with lastModified or dateOfBirth bounds where possible. A very wide lastModified range with no other scoping can 408 (timeout) on large tenants; retry with a smaller window or use cursor pagination (lastId with lastModified—see parameter descriptions).

Empty results: 200 with data: [] means no patients matched; it does not indicate invalid filter values.

responseFields: Use only names allowed on this operation (see the responseFields parameter). Use ALL or the documented flat field list.

Pagination: The page query parameter is deprecated; lastModified / lastId style pagination is preferred.

## Creates a new patient

 - [POST /v1/patients](https://papidocs.hs1api.com/publicapi/api-patient-management/patients-(v1)/createpatient.md): Creates a resource from the request body. Validation errors return 400; a successful create returns 201 with the created resource in data.

## Returns a list of patients (V1) asynchronously based on filter criteria

 - [GET /v1/patients/async](https://papidocs.hs1api.com/publicapi/api-patient-management/patients-(v1)/getallpatientsasync.md): Retrieves patients asynchronously. Returns the first 10 results immediately and streams all matching records to the Streaming API.

## Returns a patient by patient ID

 - [GET /v1/patients/{patientId}](https://papidocs.hs1api.com/publicapi/api-patient-management/patients-(v1)/getpatientbyid.md): Returns the patient identified by the path parameter. 404 when the patient is missing or not accessible in the organization context.

## Updates an existing patient

 - [PUT /v1/patients/{patientId}](https://papidocs.hs1api.com/publicapi/api-patient-management/patients-(v1)/updatepatient.md): Updates the resource identified by the path parameter. Validation errors return 400; 404 when the resource is missing.

## Returns a list of objects with calculated fields for Patient based on filter criteria

 - [GET /v1/patients/calculated](https://papidocs.hs1api.com/publicapi/api-patient-management/patients-(v1)/getpatientcalculatedfields.md): Returns calculated fields per patient row. Required: filter (narrow with patient.id==… or patient.id->[…]) and
responseFields listing at least one allowed field (for example lastVisitDate). Requests missing either or using
unsupported field names typically return 400.