Overview

All customer endpoints are under /v1/* and use API key auth.

Base headers

Authorization: Bearer <api_key>
Content-Type: application/json

Write safety

For write endpoints, send Idempotency-Key when possible.

Response shape

Success payloads are endpoint-specific. Errors use a standard shape:

{
  "error": {
    "code": "SOME_CODE",
    "message": "Human readable message",
    "details": {}
  }
}

See /docs/api-reference/errors and /docs/api-reference/scopes.