---
url: /errors/document_too_large.md
---
# `DOCUMENT_TOO_LARGE`

`DOCUMENT_TOO_LARGE`

## Description

The document holds more than 20 MB (20 971 520 bytes). The limit keeps the requests short. It is larger than a signed contract with its annexes.

## HTTP Status

`422 Unprocessable Entity`

## `doc_url` Format

The `doc_url` value is an absolute URL and changes by environment:

`<docs-base-url>/errors/document_too_large`

## Typical Causes

* The document holds scanned pages at a high resolution.
* The client sent an archive of several documents in one part.

## Example

Request: `POST /v1/certification/certifications` with a document of 25 MB.

Response:

```json
{
  "errors": [
    {
      "code": "DOCUMENT_TOO_LARGE",
      "message": "The document holds more than 20971520 bytes",
      "doc_url": "https://docs.example.com/errors/document_too_large"
    }
  ]
}
```

## How To Fix

1. Make the document smaller, for example with a lower scan resolution.
2. Certify each document of an archive in a separate request.