---
title: "List patient health metrics"
method: GET
path: "/patient_health_metric"
tags: ["metric"]
---

# List patient health metrics

`GET /patient_health_metric`

## Request

- Base URL: `https://api.twinehealth.com/pub`
- URL: `https://api.twinehealth.com/pub/patient_health_metric`
- Auth: none declared

Get a list of patient health metrics.

## Query parameters

- `filter[patient]` string
- `filter[groups]` string
- `filter[organization]` string
- `page[number]` integer
- `page[size]` integer
- `page[limit]` integer
- `page[cursor]` string

## Response `200`

OK

- FetchPatientHealthMetricResponse
  - `meta` FetchMetaResponse
    - `req_id` string
    - `count` integer
  - `links` CollectionResponseLinks
    - `self` string
    - `next` string
    - `prev` string
    - `last` string
  - `data` PatientHealthMetricResource[], required
    - `type` string, required
    - `id` string, required
    - `attributes` object
      - `type` 'blood_pressure_systolic' | 'blood_pressure_diastolic' | 'hemoglobin_a1c' | 'hdl_cholesterol' | 'ldl_cholesterol' | 'total_cholesterol' | 'triglycerides' | 'blood_urea_nitrogen' | 'creatinine' | 'hemoglobin' | 'hematocrit' | 'total_serum_iron' | 'thyroid_stimulating_hormone' | 'free_thyroxine' | 'free_triiodothyronine' | 'total_triiodothyronine' | 'cd4_cell_count' | 'hiv_viral_load' | 'inr' | 'free_testosterone' | 'total_testosterone' | 'c_reactive_protein' | 'prostate_specific_antigen' | 'cotinine' | 'c_peptide' | 'blood_pressure' | 'blood_glucose' | 'weight' | 'heart_rate' | 'body_fat_percentage' | 'body_mass_index' | 'body_temperature' | 'forced_expiratory_volume1' | 'forced_vital_capacity' | 'lean_body_mass' | 'nausea_level' | 'oxygen_saturation' | 'pain_level' | 'peak_expiratory_flow_rate' | 'peripheral_perfusion_index' | 'respiratory_rate' | 'inhaler_usage'
      - `code` object
        - `system` string, required
        - `value` string, required
      - `value` unknown
      - `systolic` number
      - `diastolic` number
      - `unit` string
      - `occurred_at` string, dateTime
    - `relationships` object
      - `patient` object
        - `data` object
          - `type` string
          - `id` string: Required if the `meta.query` is not defined.
          - `meta` object: Allows the specification of a query for a patient rather than providing a patient id directly
            - `query` object, required: The query must return one and only one patient.
              - …
        - `links` object

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `409`: Invalid Request

## Changes

- **2026-07-13** `1c92481b5836`: 3 info
  - added the new optional `query` request parameter `filter[groups]`
  - added the new optional `query` request parameter `filter[organization]`
  - the `query` request parameter `filter[patient]` became optional
- **2018-04-10** `71ddc86c0d0e`: 2 info
  - added the new optional `query` request parameter `page[cursor]`
  - added the new optional `query` request parameter `page[limit]`

[Operation history](https://skmtc.dev/twinehealth/apis/fitbit-plus-api/changes/patient_health_metric/get.md)

---

[API](https://skmtc.dev/twinehealth/apis/fitbit-plus-api.md) - [All operations](https://skmtc.dev/twinehealth/apis/fitbit-plus-api/llms.txt) - [OpenAPI document](https://skmtc.dev/twinehealth/apis/fitbit-plus-api/revisions/1c92481b5836?raw)