List a product's supply-chain traceability records (BoM)
GET/api/v1/products/:id/traceability
Required scope: dpp:read. Cross-tenant / unknown id returns 404. Rate-limited per key.
Request
Responses
- 200
- 403
- 404
- 429
- 503
Traceability records
403 — missing scope (FORBIDDEN_SCOPE) or module (FORBIDDEN_MODULE).
404 — not found OR owned by another tenant (NOT_FOUND; IDOR-safe).
429 — RATE_LIMITED (per-key limit, reads and writes alike; fails closed,
so a limiter outage also returns 429). A limiter-down 429 is deliberately
indistinguishable from a quota 429. Carries Retry-After (seconds).
Response Headers
Retry-After
Seconds to wait before retrying (429 only).
RateLimit-Limit
Per-minute request ceiling for this key's tier.
RateLimit-Remaining
Requests left in the current window (floored at 0).
RateLimit-Reset
Seconds until the window resets.
503 — the API is not enabled on this environment (FEATURE_DISABLED).