Skip to main content

Error codes

All Firmium API endpoints require a valid API key. The API signals errors with standard HTTP status codes. Error responses are JSON; most contain a detail field with a human-readable message. The message text can change, so rely on the HTTP status code in your code.

400: Bad Request

The request is malformed or incomplete. For invalid input, the body lists the affected fields with their messages.

403: Forbidden

The API key is missing, invalid, or revoked, or your plan does not include API access.

404: Not Found

The requested resource does not exist.

429: Too Many Requests

The rate limit was exceeded. The Retry-After header states how many seconds to wait. See Rate limits.

500: Internal Server Error

An unexpected error occurred. Retry later.