/api/v1/products/{id}/linksGet the dealer link pack
Returns the dealer link pack of a product: every published passport with its serial, passport URL and status, plus the product's model page URL. It is the one-call answer to a dealer's request under ESPR Article 10(3)(b), which asks for a webpage link or a copy of the data carrier within five working days of the request.
Only published passports are listed; draft, in-review, suspended, expired, archived and deleted passports are left out. URLs use the company's verified custom domain when it has one. The model page (/01/{gtin}) is a public page with only the values true of every unit: the product's name, description and images, the company's contact, and the public field values identical in every published passport. It carries no data of a single unit and no restricted data. It is not a passport. A product whose passports are not GS1-addressed has no model page, and models is empty.
format=json (default) is paged in passport-id order, at most limit rows per page (default 1000, maximum 5000); pass the response's nextCursor as cursor for the next page. format=csv streams every published passport with the columns serial, passport_url, status. It is a machine format, so do not open it in a spreadsheet without care. format=zip holds passports.csv (spreadsheet-safe), message.txt (a short text to forward) and the model page QR as model-qr-{gtin}.png, and answers 413 pack_too_large above 50,000 published passports; use csv then. The JSON carries qrApiUrl for each passport, an API route that needs your credentials, so it is in no file meant for a dealer. Counts as one v1 read.
Path parameters
- idrequired
string (24 hex chars)
Product ID.
e.g. 6650a1b2c3d4e5f6a7b8c9d0
Query parameters
- format
string
json(default),csvorzip.e.g. zip
- limit
integer (1–5000)
Rows per page, default 1000.
jsononly.e.g. 1000
- cursor
string
The previous page's
nextCursor.jsononly.
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
# Paged JSON (default)
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?limit=1000" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"
# The file to send to a dealer: passports.csv, message.txt and the model page QR
curl -sS "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links?format=zip" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" -o dealer-pack.zipResponse
{
"productId": "6650a1b2c3d4e5f6a7b8c9d0",
"productName": "Li-Ion 48V Battery Pack",
"productModel": "BP-48V-100",
"models": [
{
"gtin": "09506000134352",
"modelUrl": "https://id.tracepass.eu/01/09506000134352",
"qrApiUrl": "https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0/links/model-qr?gtin=09506000134352"
}
],
"passports": [
{
"passportId": "6650b2c3d4e5f6a7b8c9d0e1",
"serial": "SN-0001",
"passportUrl": "https://id.tracepass.eu/01/09506000134352/21/SN-0001",
"qrApiUrl": "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/qr?format=png",
"status": "published"
}
],
"nextCursor": null
}