/api/v1/scope/catalogueОтчет за обхвата на каталога
Връща отчета за обхвата на каталога: за всеки продукт (и всяко уникално множество факти за паспорти) дали типът продукт изисква цифров продуктов паспорт, от кога, на какво ниво, приложимия акт и члена, и статуса на паспорта (`missing`, `draft_only`, `published_incomplete`, `published`, `not_required`, `open_questions` или `not_covered`). Пълният отговор за даден елемент е `POST /api/v1/scope/check` с неговия `productId`.
Изисква Growth или по-висок план (`scopeCatalogueEnabled`). При по-нисък план endpoint-ът връща 403 `plan_upgrade_required`. Едно четене от дневния лимит за четене на страница. Резултатите са от последното приключено изпълнение; извикайте `POST /api/v1/scope/catalogue/runs` за обновяване.
Query параметри
- classification
string
Филтър по статус на паспорта: `missing`, `draft_only`, `published_incomplete`, `published`, `not_required`, `open_questions` или `not_covered`.
- category
string
Филтър по slug на продуктова категория.
- changed
boolean
При `true` връща само редовете, променени от последното изпълнение.
- cursor
string
Непрозрачен курсор от полето `nextCursor` на предишната страница.
- limit
integer (1–500)
Размер на страницата (по подразбиране 50, максимум 500).
Хедъри
- Authorizationзадължително
string
`Bearer <token>` — или `tp_` API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.
e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Заявка
curl -sS "https://app.tracepass.eu/api/v1/scope/catalogue?classification=missing&limit=50" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Отговор
{
"run": { "id": "6acbb533c5553f06d833479e", "finishedAt": "2026-10-11T16:11:31.619Z", "rulesFingerprint": "86a23cce6480bffb91d360b7a199b473" },
"running": null,
"totals": {
"rows": 1,
"byClassification": { "missing": 0, "draft_only": 0, "published_incomplete": 0, "published": 0, "not_required": 0, "open_questions": 1, "not_covered": 0 },
"tiles": { "now": 0, "later": 0, "waiting": 0, "not_required": 0, "depends": 1, "not_covered": 0, "changed": 0 }
},
"items": [
{
"productId": "6acbb529ef6a5037c63fff80",
"productName": "e2e-fixture product",
"category": "battery",
"gtin": "09506000E2EFIX",
"passportIds": ["6acbb529ef6a5037c63fff81"],
"passportCount": 1,
"publishedCount": 1,
"summary": { "status": "needs_input", "inScope": "depends", "governing": { "celex": "32023R1542" }, "alsoApplies": [], "openQuestions": ["battery.sealed", "battery.weightKg", "battery.capacityKWh", "battery.use", "battery.vehicleCategory"], "ruleStatus": "verified" },
"classification": "open_questions",
"changed": false,
"changedAt": null
}
],
"nextCursor": null,
"disclaimer": "Regulatory information as of 9 Oct 2026, not legal advice. Check the cited articles before relying on it. — TracePass"
}