TracePass
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`. Counts as one v1 read.

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`. Counts as one v1 read.

Path parameters

  • idrequired

    ObjectId

    Product ID.

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

Headers

  • Authorizationrequired

    string

    `Bearer <api-key>`.

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": "batteries",
  "templateId": "6650a1b2c3d4e5f6a7b8c9d1",
  "defaultFieldValues": {
    "battery_chemistry": "lithium-ion",
    "nominal_voltage": 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"
}