> For the complete documentation index, see [llms.txt](https://docs.webz.io/llms.txt). Any docs page is also available as markdown at `https://docs.webz.io/markdown/<environment>/<slug>`.

# Errors, Limits & Credits

Contract plans are charged only after an answer is produced successfully. Pay-as-you-go accounts pay per answer, with a small charge for a request that was accepted but failed.

## Rate limits

Requests are rate-limited per token, about **1 request per second**. Sending faster returns `429` with the `X-RateLimit-Reason: rate_limit` header. Contact support@webz.io if you need a higher limit.

## Errors

Errors from the gateway are plain text; errors from the answer service are `{ "detail": "message" }`.

| HTTP status | `X-RateLimit-Reason` | When it happens |
| --- | --- | --- |
| `400` | | The JSON body is missing or has no `query`. |
| `401` | | Unknown token, an additional (secondary) token, or - on contract plans - no Dark Web API permission. |
| `402` | `insufficient_balance` | Pay as you go: your balance is below the price of one answer. |
| `429` | `rate_limit` | Too many requests. |
| `429` | `quota_exceeded` | Contract plans: no Dark Web Answers credits left this month. |
| `429` | `inactive_user` | Your account email is not verified yet. |
| `502` | | The answer service is temporarily unavailable - retry. |

## Credits and PAYG pricing

| Plan | Price per answer | Failed request |
| --- | --- | --- |
| Contract | **1 Dark Web Answers credit** (separate from Dark Web API credits) | Free |
| Pay as you go | **$0.30 per search round + $0.03 per Dark Web query**, between **$0.30** and **$1.00** | **$0.10** when the request was accepted and the service failed |

- Pay as you go: you need at least **$1.00** of balance before the call; the actual price is charged after the answer. Simple questions cost less than complex ones that need several rounds.
- Contract: one credit is needed before the call and charged only on a `200`.

Contract responses include `credits_used` and `requests_left`. Pay-as-you-go responses include `cost` and the remaining `balance`.

> [!NOTE]
> Answers are masked by default - see [Introduction](https://docs.webz.io/docs/webz/dark-web-answers-api). Need unmasked answers or a higher limit? Contact **sales@webz.io**.

