TracePass
Get started
Products

List 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.

GET/api/v1/products
Download OpenAPI 3.1
GET/api/v1/products

List 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.

No daily read counter is consumed by this endpoint.

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 <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

curl -sS \
  "https://app.tracepass.eu/api/v1/products?category=battery&page=1&limit=20" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Response

{
  "items": [
    {
      "_id": "6650a1b2c3d4e5f6a7b8c9d0",
      "name": "Li-Ion 48V Battery Pack",
      "model": "BP-48V-100",
      "category": "battery",
      "passportCount": 12,
      "status": "active",
      "createdAt": "2026-04-10T14:30:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}

Related endpoints