> ## Documentation Index
> Fetch the complete documentation index at: https://developers.1-funnel.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Error handling

> Problem Details style errors used by the External Integration API.

<Warning>
  **Developer Preview**

  This documentation describes the upcoming 1Funnel External Integration API.

  The documented API endpoints and authentication services are not yet available
  for public integration.

  You can explore the API specifications, request and response schemas, webhook
  events, and integration guides.

  Sandbox and production availability will be announced separately.
</Warning>

Errors use HTTP status codes with a Problem Details body. Typical members
include `type`, `title`, `status`, `detail`, and a machine-readable `code`.

Common statuses: `400`, `401`, `403`, `404`, `409`, `422`, `429`, `500`, `503`.

OTP-specific codes such as `otp_challenge_expired` and `otp_challenge_locked`
are defined in the OpenAPI contract. Always branch on `code` and HTTP status,
not on free-text `detail` alone.

See also [API reference: Errors](/api-reference/errors).


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