Skip to main content
The API uses standard HTTP status codes and returns errors in a consistent JSON format.

Error format

All errors return a JSON body with a message field:
Validation errors include additional detail:

Status codes

Client errors (4xx)

Server errors (5xx)

Handling errors

Common errors and solutions

Invalid API key (401)

Check that your API key is correct and included in the Authorization header. Do not use the Bearer prefix.

Insufficient credits (402)

Add credits at Account Settings.

Tool not found (404)

Verify the tool slug. Use GET /api/tools to list available tools.

Rate limit exceeded (429)

Wait before retrying. See rate limits for details on your plan’s limits.

Validation error (400)

Check the required parameters for your tool. The API rejects unknown fields — only send documented parameters.