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

# Errors and rate limits

> Understand failed requests and request allowances.

Errors return JSON with an `error` value:

| Status | Error | Meaning |
| - | - | - |
| `400` | `invalid_company_id` | The company ID is invalid. |
| `401` | `invalid_api_key` | The bearer key is missing or invalid. |
| `403` | `forbidden` | The key lacks the operation or access to the company. |
| `429` | `rate_limited` | The key has exhausted its request allowance. |

Each key has a request allowance and an idle reset period. The defaults are 600 verified requests and 60 seconds without a verified request, but your key may be configured differently. A verified request counts toward the allowance even if a later operation or company check returns `403`. After a `429`, wait until the key has had its full idle reset period without a verified request before retrying.

Every response includes `x-request-id`. When reporting a failed request, include that ID and the request timestamp. Never include the key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.