saperly
API Reference

API Reference

The full Saperly REST API, generated from the live OpenAPI contract.

The complete REST surface, generated directly from the SaperlyApi contract that apps/api serves — so it never drifts from production. Every endpoint page has an interactive Try it playground.

Base URL

https://api.saperly.com

Authentication

All data-plane requests authenticate with a bearer token:

Authorization: Bearer sk_live_...

See Authentication for scoped sk_ keys, scopes, and spend caps. The legacy snake_case v1 surface (/api/v1/*) — a drop-in for the published @saperly/sdk / saperly clients — is documented under its own group below.

Raw spec

The machine-readable spec is published at /openapi.json and rendered interactively by Scalar at /reference.

On this page