> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizbionic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> JSON-RPC and BizBionic application error codes with fix-its.

# Errors

Responses use JSON-RPC error objects: `{ code, message, data? }`. Prefer `error.data.next_actions` when present.

| Code                       | Message                  | Fix                                             |
| -------------------------- | ------------------------ | ----------------------------------------------- |
| -32700                     | Parse error              | Send valid JSON                                 |
| -32601                     | Method not found         | Check Agent Card / API Reference skill names    |
| -32602                     | Invalid params           | Supply required fields (e.g. `idempotency_key`) |
| -32000                     | Unauthorized / app error | Bearer key or read `data`                       |
| -32001                     | Not found                | Wrong id or wrong API key                       |
| -32003                     | No valid sending number  | Trust Setup + phone numbers                     |
| -32005                     | Launch preflight failed  | Resolve preflight blockers                      |
| consent\_required          | Not opted in             | `contacts.optIn` / import provenance            |
| payment\_hold              | Payment hold             | Billing portal / credits                        |
| partner\_suspended         | Partner suspended        | Contact BizBionic support                       |
| idempotency\_key\_required | Missing idempotency      | Required on `partner.send`                      |
| credits\_insufficient      | Low credits              | Top up / `partner.grantCredits`                 |

Machine-readable: [errors.json](/openapi/errors.json).

## Next steps

* [Authentication](/authentication)
* [API Reference](/api-reference)