Introduction - Unprice Documentation

The API returns a structured error for an expected request failure. Use code in your application logic. Use message to correct the request. Include requestId if you contact support.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, malformed, or not active.",
    "docs": "https://docs.unprice.dev/api-reference/errors/code/UNAUTHORIZED",
    "requestId": "req_1234567890"
  }
}

Handle errors

Check the error code and message.
Correct the request or the project configuration.
Retry only when the operation is safe to retry. Reuse the same idempotency key for a repeated usage or run request.
If the problem continues, contact support and include the full error response and requestId.

A denial is not an API error

A valid access.check or usage.consume request can return HTTP 200 with allowed: false. Inspect rejectionReason before starting paid work. runs.consume and runs.settle use accepted and reason instead. HTTP 429 means API rate limiting; your application can choose its own HTTP status when it handles a commercial denial.