/api/v1/passports/{id}/snapshotsList passport snapshots
Returns a paginated list of immutability snapshots for a passport, newest first. A snapshot is written on publish and after every change to a published, suspended, expired or archived passport — field values, translations, parties, status transitions, supplier answers, AI writes, restores — whenever what the passport asserts actually changed (EN 18221:2026 4.2). Each entry includes the snapshot id, version number, reason (e.g. published, field_edit, status_change, baseline), who caused it (actor, when known), timestamp, content hash, and whether the hash still verifies — hashValid: false indicates at-rest tampering.
Snapshots also carry restorable (whether rawFields was captured so a field-level restore is possible) and fieldCount (number of fields in rawFields, or null for evidence-only snapshots taken before rawFields existed). Passports that predate snapshots start with a baseline snapshot; history before that point was never captured.
Point in time: add ?at=<ISO 8601> to get the one snapshot valid at that instant — the full record plus validFrom and validUntil (null while current) — instead of the list. Returns 404 when the time predates the passport's first snapshot.
Hash chain. Each snapshot written since the chain began carries previousHash, the contentHash of the snapshot before it (null for the first), and hashMethod (how contentHash was computed: jcs-sha256, RFC 8785, or sorted-json-sha256 for older snapshots). A removed, inserted or changed snapshot breaks the link: each entry reports chainLink (ok, broken, or unchained for snapshots from before the chain), and chain reports valid for the whole history and, when it is not, firstBroken with the snapshot and the reason (hash_mismatch, previous_hash_mismatch, chain_restarted). The chain is checked over every snapshot of the passport, not only the requested page.
Authority access to past versions. A holder of an authority access grant can read a passport's earlier versions on the passport URL itself: add ?at=<ISO 8601> (with the grant as ?access= or Authorization: Bearer pa_…) to get the version in force at that time, as the HTML page or as JSON-LD, or ?versions=1 for the list of versions (date, version, contentHash, hashMethod, previousHash, reason, no content) with the same chain verdict. The list is paged: limit (default 100, at most 1000) and cursor (the nextCursor of the previous page). A served version carries X-TracePass-Snapshot-At, X-TracePass-Version, X-TracePass-Content-Hash, X-TracePass-Hash-Method and X-TracePass-Valid-Until headers. Restricted and public requests ignore both parameters and get the current version.
Tenant-scoped: only your company's passports are visible. Counts as one v1 passport read against the daily cap. Paginate with ?page (1-based, default 1) and ?limit (1–100, default 20).
Path parameters
- idrequired
string (24 hex chars)
Passport ID.
Query parameters
- page
integer
Page number (1-based, default 1).
- at
string (ISO 8601)
Return the snapshot valid at this instant instead of the list.
e.g. 2026-09-29T12:00:00Z
- limit
integer
Page size (1–100, default 20).
Headers
- Authorizationrequired
string
Bearer <token>— either atp_API key (Developer → API Keys; simplest, for server-to-server) or an OAuth 2.0 access token (Developer → OAuth Apps; for user-authorized apps, scoped + revocable). The Authentication page has the full OAuth flow and scope list.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Request
curl -sS "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/snapshots?limit=5" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Response
{
"entries": [
{
"id": "65a0f1b2c3d4e5f6a7b8c9d1",
"version": 3,
"reason": "republished",
"snapshotAt": "2026-09-15T14:32:00.000Z",
"contentHash": "sha256:a3f1c2d4e5b6a7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2",
"hashMethod": "jcs-sha256",
"previousHash": "sha256:b4e2d3c5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3",
"hashValid": true,
"chainLink": "ok",
"restorable": true,
"fieldCount": 142
},
{
"id": "65a0f1b2c3d4e5f6a7b8c9d0",
"version": 1,
"reason": "published",
"snapshotAt": "2026-08-01T09:00:00.000Z",
"contentHash": "sha256:b4e2d3c5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3",
"hashMethod": "sorted-json-sha256",
"hashValid": true,
"chainLink": "unchained",
"restorable": false,
"fieldCount": null
}
],
"total": 2,
"page": 1,
"limit": 20,
"totalPages": 1,
"chain": { "valid": true }
}