---
title: "List a passport's measurement history."
method: GET
path: "/api/v1/passports/{id}/measurements"
tags: ["Passports"]
---

# List a passport's measurement history.

`GET /api/v1/passports/{id}/measurements`

## Request

- Base URL: `https://app.tracepass.eu`
- URL: `https://app.tracepass.eu/api/v1/passports/{id}/measurements`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.tracepass.eu/api/oauth/authorize`, token URL `https://app.tracepass.eu/api/oauth/token`, scopes: `passports:read`)

Newest first. Filter by `fieldKey` and a `from`/`to` window on
`measuredAt`; page with `cursor` (the previous page's `nextCursor`).

## Query parameters

- `fieldKey` string
- `from` string, date-time
- `to` string, date-time
- `limit` integer
- `cursor` string

## Response `200`

A page of measurements.

- object
  - `data` PassportMeasurement[], required
    - `_id` string: MongoDB ObjectId hex string (24 chars).
    - `passportId` string: MongoDB ObjectId hex string (24 chars).
    - `fieldKey` string
    - `value` unknown
    - `measuredAt` string, date-time
    - `receivedAt` string, date-time
    - `externalId` string
    - `unit` string
    - `materialized` boolean
    - `source` string
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required

## Other responses

- `401`: Missing or invalid API key.
- `404`: Resource doesn't exist or is in a different workspace.
- `429`: Daily v1 write or passport-read budget exhausted. Resets at 00:00 UTC.

---

[API](https://skmtc.dev/tracepass/apis/tracepass-api.md) · [All operations](https://skmtc.dev/tracepass/apis/tracepass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracepass/apis/tracepass-api/revisions/60ddeb25638b?raw)