GET
/api/v1/productsList products
Paginated list of every product the workspace owns, sorted by `createdAt` descending. Page size capped at 100. Filter by category slug, status (`active` / `archived`), or a free-text search across name + model.
Counts as one v1 read against `maxV1PassportsPerDay` (the read-side budget — same counter as the passport list endpoint). Reads aren't counted against the write budget.
Query parameters
- page
number (default 1)
1-based page number.
- limit
number (1-100, default 20)
Items per page.
- category
string
Filter by category slug.
- status
string
`active` or `archived`.
- search
string
Free-text search across name and model.
Headers
- Authorizationrequired
string
`Bearer <api-key>`.
Request
curl -sS \
"https://app.tracepass.eu/api/v1/products?category=batteries&page=1&limit=20" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Response
{
"data": {
"items": [
{
"_id": "6650a1b2c3d4e5f6a7b8c9d0",
"name": "Li-Ion 48V Battery Pack",
"model": "BP-48V-100",
"category": "batteries",
"passportCount": 12,
"status": "active",
"createdAt": "2026-04-10T14:30:00.000Z"
}
],
"total": 1,
"page": 1,
"limit": 20,
"totalPages": 1
}
}