How to read these pages
Each endpoint page renders three blocks in order: (1) the canonical request shape (method, path, headers, body schema), (2) the canonical response shape (status code, body schema — including the 402 envelope), and (3) a copy-curling example. The sandbox form on every page is wired to a same-origin proxy at /api/docs/<endpoint> so a partner can fire an actual call against the live DB without leaving the page.