---
title: "List observations"
method: GET
path: "/v1/patients/{patient_id}/observations"
tags: ["REST v1"]
---

# List observations

`GET /v1/patients/{patient_id}/observations`

## Request

- Base URL: `https://platform.anpheros.com`
- URL: `https://platform.anpheros.com/v1/patients/{patient_id}/observations`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://platform.anpheros.com/oauth/authorize`, token URL `https://platform.anpheros.com/oauth/token`; client credentials, token URL `https://platform.anpheros.com/oauth/token`, scopes: `patient/*.rs`, `patient/Observation.rs`, `patient/Observation.rs?category=laboratory`, `patient/Condition.rs`, `patient/MedicationStatement.rs`, `patient/DocumentReference.rs`, `patient/AllergyIntolerance.rs`, `offline_access`, `openid`, `fhirUser`, `anpheros/patterns`)

## Path parameters

- `patient_id` string, required

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `category` 'vital-signs' | 'laboratory' | 'symptom' | 'activity' | 'survey' | 'exam' | 'imaging' | 'social-history'
- `code` string
- `from` string
- `to` string

## Headers

- `authorization` string, nullable
- `X-Api-Key` string, nullable
- `X-Anpheros-Acting-As` string, nullable
- `X-Anpheros-On-Behalf-Of` string, nullable

## Response `200`

Successful Response

- ObservationPage
  - `data` ObservationOut[], required
    - `id` string, required
    - `patient` string, required
    - `code` string, required
    - `system` string, nullable, required
    - `display` string, nullable, required
    - `category` string, nullable, required
    - `effective_at` string, nullable, required
    - `value` number, nullable, required
    - `unit` string, nullable, required
    - `value_text` string, nullable, required
    - `components` Component[], required
      - `code` string, required
      - `system` string, nullable
      - `display` string, nullable
      - `value` number, required
      - `unit` string, nullable
    - `reference_range` ReferenceRange, required
      - `low` number, nullable
      - `high` number, nullable
    - `note` string, nullable, required
    - `derived_from` string[], required
    - `status` string, nullable, required
    - `updated_at` string, nullable, required
    - `fhir` string, required
  - `total` integer, required
  - `next_cursor` string, nullable

## Other responses

- `401`: Missing, invalid, expired or revoked credential (`WWW-Authenticate: Bearer`).
- `403`: The credential's scope or the patient's consent does not allow this.
- `422`: Validation Error
- `429`: Rate limit exceeded; wait `Retry-After` seconds.

---

[API](https://skmtc.dev/anpheros/apis/anpheros-platform.md) · [All operations](https://skmtc.dev/anpheros/apis/anpheros-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/anpheros/apis/anpheros-platform/revisions/ff567b232dc3?raw)