List your company's GS1 prefixes and claim statuses
GET/api/v1/companies/me/gs1-prefixes
Required scope: dpp:read. prefixes contains only VERIFIED
prefixes — the set the publish gate honours. registrations lists
every claim with its lifecycle status (Declared / Verified /
Rejected / Revoked), decision timestamp, and machine-readable
rejection reason where applicable.
Responses
- 200
- 403
- 429
- 503
Prefixes
403 — missing scope (FORBIDDEN_SCOPE) or module (FORBIDDEN_MODULE).
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
Seconds to wait before retrying (429 only).
Per-minute request ceiling for this key's tier.
Requests left in the current window (floored at 0).
Seconds until the window resets.
503 — the API is not enabled on this environment (FEATURE_DISABLED).