---
title: "Get recent vital measurements for a patient."
method: GET
path: "/patients/{patientId}/Vitals"
tags: ["Vitals"]
---

# Get recent vital measurements for a patient.

`GET /patients/{patientId}/Vitals`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/patients/{patientId}/Vitals`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/patients/:patientId/Vitals/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `patientId` string, required

## Query parameters

- `limit` union
  - integer
  - string, int32

## Response `200`

List of vital measurements for the patient

- VitalMeasurementDetailDto[]
  - `id` string, required
  - `patientId` string, required
  - `vitalTypeCode` string, required
  - `vitalTypeLabel` string, required
  - `value` union, required: Legacy numeric reading in the vital TYPE's unit (string VitalMeasurementDetailDto.Unit); null when the stored value is text (see string? VitalMeasurementDetailDto.ValueText). Kept for readers that predate ITE-829; prefer decimal? VitalMeasurementDetailDto.CanonicalValue for computation and decimal? VitalMeasurementDetailDto.NumericValue + string? VitalMeasurementDetailDto.EnteredUnit for "what was recorded".
    - number, double
    - string, double
  - `valueText` string, nullable: Text reading; null for numeric readings.
  - `unit` string, required: The vital type's unit — what double? VitalMeasurementDetailDto.Value is in.
  - `numericValue` union: The reading as entered (ITE-829); null for text readings and unparsed legacy rows.
    - number, double
    - string, double
  - `enteredUnit` string, nullable: Unit code decimal? VitalMeasurementDetailDto.NumericValue was entered in ("kg", "lb", "c", "f", or the type's unit text).
  - `canonicalValue` union: SI canonical (kg / °C) for weight and temperature; the entered value for single-unit types.
    - number, double
    - string, double
  - `canonicalUnit` string, nullable: Unit code of decimal? VitalMeasurementDetailDto.CanonicalValue.
  - `displayValue` union: The reading in the tenant's display unit (RegionSettings: kg/lbs, °C/°F), unrounded; the client formats. Null for text readings and unparsed legacy rows (ITE-829).
    - number, double
    - string, double
  - `displayUnit` string, nullable: Label of decimal? VitalMeasurementDetailDto.DisplayValue's unit: "kg", "lbs", "°C", "°F", "bpm".
  - `takenAt` string, date-time, required
  - `takenById` string, nullable
  - `appointmentId` string, nullable
  - `notes` string, nullable
  - `isWithinRange` boolean

## Changes

- **2026-09-17** `d4ae30be0619`: 18 info
  - added the optional property `items/canonicalUnit` to the response with the `200` status (media type: text/plain)
  - added the optional property `items/canonicalUnit` to the response with the `200` status (media type: application/json)
  - added the optional property `items/canonicalUnit` to the response with the `200` status (media type: text/json)
  - added the optional property `items/canonicalValue` to the response with the `200` status (media type: text/plain)
  - …14 more
- **2026-08-26** `a57456aa87b0`: 3 breaking, 3 info
  - the response property `items/value` became nullable for the status `200` (media type: text/plain)
  - the response property `items/value` became nullable for the status `200` (media type: application/json)
  - the response property `items/value` became nullable for the status `200` (media type: text/json)
  - added the optional property `items/valueText` to the response with the `200` status (media type: text/plain)
  - …2 more

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/patients/:patientId/Vitals/get.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)