documentation

Patient Vault v3 API

Health Grid / Patient

/v3/health/grid/patient endpoint reference.

URL: https://demo.1health.io/api/v3/health/grid/patient

No description available in the API specification.

Endpoints

EndpointMethodDescription
/v3/health/grid/patientPOSTList Patients

POST/v3/health/grid/patient

List Patients

Overview

Retrieve a paginated list of patients with optional filtering and sorting.

Authorization

Bearer JWT required. See the authentication guide.

Query Parameters

ParameterTypeRequiredDefaultDescription
pageintNo0Page number (0-indexed)
sizeintNo50Number of items per page
includeLabelTagsbooleanNofalseWhether to include label tags in the response

Request Body

Content-Type: application/json · DTO: RootDataRequest

{
  "filterBy": [
    {}
  ],
  "orderBy": [
    {}
  ]
}
FieldTypeRequiredConstraintsDescription
filterByListNoList of filter conditions to apply to the grid data. Each filter specifies: - key: The column/field to filter on - operator: The comparison operator (equals, contains, greaterThan, etc.) - value: The value to filter by All filters are combined with AND logic. For multiple OR conditions, use the 'in' operator.
orderByListNoList of sort conditions to apply to the grid data. Each sort specifies: - key: The column/field to sort by - order: Sort direction (ASC or DESC) - priority: Optional sort priority for multi-column sorting Lower priority numbers are applied first.

Responses

200 OK

Paginated list of patients

DTO: Page

{
  "data": [
    {}
  ],
  "pageNumber": 1,
  "pageSize": 1,
  "offset": 1001,
  "emptyPage": true,
  "firstPage": true,
  "lastPage": true,
  "numberOfElements": 1001,
  "totalElements": 1001,
  "totalPages": 1
}
FieldTypeNullableDescription
dataListNo
pageNumberintNo
pageSizeintNo
offsetlongNo
emptyPagebooleanNo
firstPagebooleanNo
lastPagebooleanNo
numberOfElementslongNo
totalElementslongNo
totalPagesintNo

Example

curl -X POST "https://demo.1health.io/api/v3/health/grid/patient" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{"filterBy": [{}], "orderBy": [{}]}'

Parent: https://agents.1health.io/public/demo/api/v3/health/grid/agents.md · Site guide: https://agents.1health.io/public/demo/api/agents.md