Status codes

Every status below appears in the published document. The meaning is the one this API gives it, which is not always the one the RFC gives it: read 404 and 422 here before assuming.

The body of a refusal

⚠️ Two shapes coexist in this API, and a client that parses one as the other reads undefined where it expected a string. The newer routes answer:

{
  "error": {
    "code": "not_found",
    "message": "paywall not found"
  },
  "request_id": "req_01J8…"
}

Older routes answer a bare { "error": "not_found" }, sometimes with an issues array alongside it when the refusal is a validation failure. Each operation's page shows the shape that operation actually returns — read it there rather than assuming.

The codes INSIDE that body, and the fix for each, are in the error reference.