> ## Documentation Index
> Fetch the complete documentation index at: https://signatureapi-daf4ee54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Handle API errors with RFC 7807 problem details, HTTP status codes, and validation error responses

SignatureAPI uses conventional HTTP response codes to indicate the success or failure of an API request. In general:

* Codes in the `2XX` range indicate success.
* Codes in the `4XX` range indicate problems with the request, like missing parameters.
* Codes in the `5XX` range indicate problems with SignatureAPI servers.

Errors messages conform to [RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807) and use a Content-Type of `application/problem+json`.

## General Errors

This payload is for `4XX` client errors, except validation errors, and `5XX` errors.

<ResponseField name="type" type="string">
  A URL that identifies the problem type. Visit the URL to learn more about this problem.
</ResponseField>

<ResponseField name="title" type="string">
  short, human-readable summary of the problem type
</ResponseField>

<ResponseField name="status" type="integer">
  The HTTP status code generated by the server for this occurrence of the problem
</ResponseField>

<ResponseField name="detail" type="string">
  A human-readable explanation specific to this occurrence of the problem.
</ResponseField>

#### Example

```json theme={null}
{
  "type": "https://signatureapi.com/docs/v1/errors/invalid-api-key",
  "title": "Invalid API Key",
  "status": 401,
  "detail": "Please provide a valid API key in the X-API-Key header."
}
```

## Validation Errors

This payload is for validation errors (along a `422` status code).

<ResponseField name="type" type="string">
  A URL that identifies the problem type. Visit the URL to learn more about this problem.
</ResponseField>

<ResponseField name="title" type="string">
  short, human-readable summary of the problem type
</ResponseField>

<ResponseField name="status" type="integer">
  The HTTP status code generated by the server for this occurrence of the problem.

  For validation errors, this value is always `422`.
</ResponseField>

<ResponseField name="errors" type="array of Strings">
  A human-readable list of specific validation errors.
</ResponseField>

#### Example

```json theme={null}
{
  "type": "https://signatureapi.com/docs/v1/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "errors": [
    "documents[0].url protocol must be HTTPS",
    "recipients[0].email must be a valid email address"
  ]
}
```