- Docs
- Getting started
- Errors & status codes
Errors & status codes
Errors use standard HTTP status codes and a JSON body that says what went wrong.
Status codes
| Status | Meaning | What to do |
|---|---|---|
| 402 | Payment required, or the payment was missing, too small or invalid. | Pay the amount in the reply and retry with X-PAYMENT. Check your USDC balance. A wallet that is a smart account or has EIP-7702 delegation is always rejected; use a regular account. |
| 400 | A parameter is missing or has the wrong value. | Check the endpoint's parameters; an enum value must be one of the listed values. |
| 404 | The path does not exist, or the endpoint is turned off. | Check the path in the catalog. |
| 5xx | The actor behind the endpoint is unavailable or did not answer in time. | Retry later. |
Are failures charged?
A 402 is never charged: nothing was paid yet. A paid 200 costs the endpoint price. Whether a failed paid call (400, 404, 5xx) is charged is not documented yet.