Source: https://www.cleanmylist.io/help/api/errors-and-status-codes
Markdown source: https://www.cleanmylist.io/help/api/errors-and-status-codes.md
Description: What the different responses mean and how fast you can send requests.

# Errors and limits

Updated: 2026-06-12

If something is not right, the API replies with a status code and a short message telling you what happened.

| Code | Meaning |
| --- | --- |
| 200 / 201 / 202 | Success — your request worked. |
| 400 | Something in your request was missing or wrong. |
| 401 | Your API key is missing or invalid. |
| 402 | Your workspace is out of credits — top up to continue. |
| 403 | Confirm your account email before running checks. |
| 404 | We could not find what you asked for (for example, a job). |
| 409 | Not ready yet, or the job is in the wrong state for that action. |
| 413 | Your request was too big — send a link to a CSV file instead. |
| 429 | Too many requests too quickly — slow down and retry. |
| 500 | Something went wrong on our side — try again shortly. |

## Rate limit

By default you can send up to 1,000 requests per minute. Each API key gets its own allowance, and a connected AI assistant gets its own too, so one busy integration will not slow down another. Need more? Get in touch and we will raise it.

> **Tip:** If you hit the limit (a 429 response), wait a moment and try again. Spacing your requests out evenly is the easiest way to stay under it.