TracePass
Products

Render the model page QR

Renders the QR code of the product's model page, the bare GS1 address /01/{gtin} listed in GET /api/v1/products/{id}/links. The model page shows only the public values identical across every published unit, so the code suits an online listing or a dealer; each unit keeps its own passport. Black on a transparent background. Counts as one v1 read.

GET/api/v1/products/{id}/links/model-qr
Download OpenAPI 3.1
GET/api/v1/products/{id}/links/model-qr

Render the model page QR

Renders the QR code of the product's model page, the bare GS1 address /01/{gtin} listed in GET /api/v1/products/{id}/links. The model page shows only the public values identical across every published unit, so the code suits an online listing or a dealer; each unit keeps its own passport. Black on a transparent background. Counts as one v1 read.

Answers 404 model_not_found when the product has no published GS1 passport with that GTIN (so no model page), 400 invalid_gtin when gtin is not 14 digits, and 400 gtin_required when the product's published passports carry more than one GTIN and gtin is missing.

Path parameters

  • idrequired

    string (24 hex chars)

    Product ID.

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

Query parameters

  • format

    string

    svg (default) or png.

    e.g. png

  • gtin

    string (14 digits)

    Needed only when the product's published passports carry more than one GTIN.

    e.g. 09506000134352

Headers

  • Authorizationrequired

    string

    Bearer <token> — either a tp_ 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

# SVG (default)
curl -sS https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.svg

# PNG for one GTIN
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr?format=png&gtin=09506000134352" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.png

Response

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 29 29">
  <!-- QR modules encoding https://id.tracepass.eu/01/<gtin> -->
</svg>