Errors - Qismah Public API

The API returns standard HTTP status codes and JSON error bodies from the Qismah backend.

Common errors

Status	Meaning
`400`	The request body or query is invalid.
`401`	The API token is missing, invalid, revoked, or expired.
`402`	The action requires Qismah Plus, including public API access.
`404`	The requested resource does not exist or is not visible to the token owner.
`500`	Unexpected server error.

Validation errors usually include a message field with one or more problems. Fix the request body first, then retry.

{
  "statusCode": 401,
  "message": "API token is required",
  "error": "Unauthorized"
}

Error message wording can change. Use HTTP status codes and machine-readable fields when available.