/api/v1/products/{id}/links/model-qrRender 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) orpng.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 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
# 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>in=09506000134352" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o model-qr.pngResponse
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 29 29">
<!-- QR modules encoding https://id.tracepass.eu/01/<gtin> -->
</svg>