Getting started

Errors

Errors use normal HTTP status codes and always have the same JSON shape.

Error format

JSON

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key (Authorization: Bearer cp_sk_…)"
  }
}

HTTP	Code	Meaning
400	`invalid_cursor`	starting_after isn't a valid order id.
401	`unauthorized`	The API key is missing or wrong.
404	`not_found`	The endpoint or the object doesn't exist (or belongs to another store).
405	`method_not_allowed`	That method isn't supported here – use GET (or POST /v1/checkouts).
429	`rate_limited`	More than 120 requests in a minute. Wait and try again.