Changelog

The /api/v1 facade is versioned as a whole (there is no per-endpoint versioning yet) — this page tracks what’s been added since the facade was introduced. All dates are the day each phase’s backend work landed.

2026-08-02 — Self-service profile & credentials

• Added the API Credentials self-service window in the Portal dashboard (not a new API endpoint) — see Credentials.

2026-08-01 — Billing statements & activity

• Added GET /api/v1/statements (persisted list + mode=report on-demand provisional report) and GET /api/v1/statements/{id}.

2026-08-01 — Self-serve returns

• Added POST /api/v1/scent/orders/{id}/return-request and GET /api/v1/scent/orders/{id}/return-requests.

2026-08-01 — Checkout price locking

• Added ?lock=true to GET /api/v1/scent/cart/checkout-preview, and the corresponding lockId field on POST /api/v1/orders/scent — see Cart preview & price locks.

2026-08-01 — Partner reads

• Added the unified cross-product order list/detail (GET /api/v1/orders, GET /api/v1/orders/{orderGlobalId}).
• Added GET /api/v1/wallet/balance and GET /api/v1/wallet/transactions (self-only reads).
• Added changedSince delta-sync support to the scent catalog list endpoints — see Catalog delta sync.

2026-08-01 — Webhook delivery

• Added the full /api/v1/webhooks/** subscription-management and delivery-history surface — see Webhooks & HMAC verification.

2026-08-01 — API foundation

• Introduced the /api/v1 facade itself (this document’s whole subject) over the previously unversioned Gateway routes.
• Introduced fleet-wide rate limiting on every /api/v1 route — see Rate limits.

---

Have feedback on this documentation, or think something here doesn’t match what you’re actually seeing from the API? This document is generated from, and checked against, the real Gateway route table on every build — if you find a mismatch, it’s a bug in either the docs or the API, and we want to know about it either way.