Passports

List immutability snapshots for a passport.

Returns a paginated list of immutability snapshots for a passport, newest first. Each entry re-verifies the stored content hash so an at-rest tamper is visible (hashValid: false) rather than silently trusted.

A snapshot is written on publish and after every change to a non-draft (published, suspended, expired or archived) passport — field values, statuses, translations, parties, status transitions, supplier answers, AI writes, restores — whenever what the passport asserts actually changed (EN 18221:2026 4.2). Changes made outside the API are captured too, within a day. Passports that predate snapshots start with a baseline snapshot.

Point in time: ?at=<ISO 8601> returns the single snapshot valid at that instant — the SnapshotDetail shape plus validFrom and validUntil (null while current) — instead of the list. 404 when at predates the passport's first snapshot.

Read-only; counts as one v1 passport read against the daily cap.

get/api/v1/passports/{id}/snapshots

Request

  • Base URL: https://app.tracepass.eu
  • URL: https://app.tracepass.eu/api/v1/passports/{id}/snapshots
  • 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)

Query parameters

pageinteger
limitinteger
atstring date-time

Return the snapshot valid at this instant instead of the list.

Response

Paginated snapshot list, or with ?at= the snapshot valid then (SnapshotDetail plus validFrom / validUntil).

totalinteger required

Total snapshots matching the query across all pages.

pageinteger required

Current page number (1-based).

limitinteger required

Page size used for this response.

totalPagesinteger required

Total number of pages at the current limit.

Changes

No recorded changes to this operation across all 1 revision of this API.