TracePass
Get started
Products

Get a single product

Read one product by ID. Returns the full document including default field values, image URLs, template reference, and the running passportCount. No daily read counter is consumed by this endpoint.

GET/api/v1/products/{id}
Download OpenAPI 3.1
GET/api/v1/products/{id}

Get a single product

Read one product by ID. Returns the full document including default field values, image URLs, template reference, and the running passportCount. No daily read counter is consumed by this endpoint.

Path parameters

  • idrequired

    string (24 hex chars)

    Product ID.

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

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/6650a1b2c3d4e5f6a7b8c9d0 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Response

{
  "_id": "6650a1b2c3d4e5f6a7b8c9d0",
  "name": "Li-Ion 48V Battery Pack",
  "model": "BP-48V-100",
  "category": "battery",
  "templateId": "6650a1b2c3d4e5f6a7b8c9d1",
  "defaultFieldValues": {
    "batteryChemistry": "NMC",
    "nominalVoltage": 48
  },
  "imageUrls": [
    "https://cdn.example.com/products/battery-pack-hero.jpg"
  ],
  "passportCount": 12,
  "status": "active",
  "createdAt": "2026-04-10T14:30:00.000Z",
  "updatedAt": "2026-04-12T09:15:00.000Z"
}

Related endpoints