TracePass
Get started
Passports

Archive a passport (irreversible)

**Irreversible.** Public viewer returns 404, the GS1 Digital Link URL stops resolving, the QR code dies for good. Use ONLY for products that never shipped — archiving a passport for a product already in customers' hands breaks every QR scan they'll ever make of it.

POST/api/v1/passports/{id}/archive
Download OpenAPI 3.1
POST/api/v1/passports/{id}/archive

Archive a passport (irreversible)

**Irreversible.** Public viewer returns 404, the GS1 Digital Link URL stops resolving, the QR code dies for good. Use ONLY for products that never shipped — archiving a passport for a product already in customers' hands breaks every QR scan they'll ever make of it.

There's no DELETE verb on purpose: too easy to misfire as a destructive action via curl typo or a misconfigured client. The HTTP method is POST and the path includes the literal `archive` segment — both intentional friction. Counts as one v1 write. Honours `Idempotency-Key`. Fires the `passport.archived` webhook.

Path parameters

  • idrequired

    ObjectId

    Passport ID.

Headers

  • Authorizationrequired

    string

    `Bearer <api-key>`.

  • Idempotency-Key

    string

    UUID v4.

Request

curl -sS -X POST \
  https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/archive \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Response

{
  "_id": "6650b2c3d4e5f6a7b8c9d0e1",
  "status": "archived",
  "archivedAt": "2026-05-09T17:00:00.000Z"
}

Related endpoints