TracePass
Започнете
Паспорти

Списък на паспортите

Пагиниран списък на паспортите в работното пространство. Филтрирайте по `productId`, `status` или free-text търсене по GTIN и сериен номер. Брои се срещу дневния бюджет за четене на паспорти (`maxV1PassportsPerDay`); елементите на отговора използват същата форма като endpoint-а за единично четене, но скъсена до полетата за списъка.

GET/api/v1/passports
Изтегли OpenAPI 3.1
GET/api/v1/passports

Списък на паспортите

Пагиниран списък на паспортите в работното пространство. Филтрирайте по `productId`, `status` или free-text търсене по GTIN и сериен номер. Брои се срещу дневния бюджет за четене на паспорти (`maxV1PassportsPerDay`); елементите на отговора използват същата форма като endpoint-а за единично четене, но скъсена до полетата за списъка.

Query параметри

  • page

    number (default 1)

    1-базиран номер.

  • limit

    number (1-100, default 20)

    Елементи на страница.

  • productId

    ObjectId

    Филтър по продукт.

  • status

    enum

    `draft`, `in_review`, `approved`, `published`, `suspended`, `expired`, `archived`.

  • search

    string

    Free-text по GTIN + сериен.

Хедъри

  • Authorizationзадължително

    string

    `Bearer <api-key>`.

Заявка

curl -sS \
  "https://app.tracepass.eu/api/v1/passports?status=published&limit=50" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "data": {
    "items": [
      {
        "_id": "6650b2c3d4e5f6a7b8c9d0e1",
        "productId": "6650a1b2c3d4e5f6a7b8c9d0",
        "gs1": {
          "gtin": "04012345000015",
          "serialNumber": "BP-48V-100-000001",
          "digitalLinkUri": "https://id.tracepass.eu/p/01/04012345000015/21/BP-48V-100-000001"
        },
        "status": "published",
        "completionPercentage": 87,
        "publishedAt": "2026-04-11T10:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 50,
    "totalPages": 1
  }
}

Свързани endpoints