---
title: "Create Documents Bulk"
method: POST
path: "/documents/bulk"
tags: ["documents"]
---

# Create Documents Bulk

`POST /documents/bulk`

Bulk upload documents with associated PDF files.

    - `documents_metadata`: JSON string matching the DocumentsBulkCreate schema.
    Example:
    {
        "documents": [
            {
                "reference": "ref1",
                "document_create": { ... },
                "associated_file": "file1.pdf"
            }
        ]
    }
    - `files`: List of PDF files to upload.

It processes the documents in batches and returns job IDs for tracking.

## Response `201`

Successful Response

- DocumentsBulkResponse — Response schema for bulk document upload.
  - `job_ids` object, required — Reference key to job_id mapping for frontend tracking
  - `total_documents` integer, required — Total number of documents in the request
  - `failed_validations` string[] — Files that failed validation

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/hf/apis/extralit-v1.md) · [All operations](https://skmtc.net/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hf/extralit-v1/revisions/e9da3a893a88/schema)