---
title: "Ingest Bulk"
method: POST
path: "/v1/ingest/bulk"
tags: ["ingress"]
---

# Ingest Bulk

`POST /v1/ingest/bulk`

## Request

- Base URL: `https://api.claims.zicron.ai`
- URL: `https://api.claims.zicron.ai/v1/ingest/bulk`
- Auth: none declared

Extract structured data from an archive (ZIP, RAR, or 7z) containing multiple documents.

Supports PDFs, text files, FHIR JSON, CCDA XML, HL7 v2, and X12 EDI within the archive.
Each document is extracted independently with the same claim context.

## Query parameters

- `claim_type` 'wc' | 'ssdi' | 'ssi' | 'va' | 'pi' | 'ltd' | 'std' | 'feca' | 'sdi' | 'medicare' | 'medicaid' | 'hospice' | 'lnc': Insurance/benefits claim types the platform supports.
- `document_type` 'medical_record' | 'ime_report' | 'msa_report' | 'first_report_of_injury' | 'wage_statement' | 'fce' | 'function_report' | 'c_and_p_exam' | 'dd_214' | 'police_report' | 'determination_letter' | 'policy_document' | 'attending_physician_statement' | 'demand_letter' | 'buddy_statement' | 'job_description' | 'billing_record' | 'work_history' | 'earnings_record' | 'service_treatment_record' | 'employer_statement' | 'settlement_document' | 'consultative_exam': All document types that flow through the platform.
- `mechanism` 'ime' | 'msa' | 'fce': Cross-cutting evaluation/settlement mechanisms that serve multiple claim types.

## Response `200`

Successful Response

- BulkExtractionResponse: Response for bulk extraction operations.
  - `success` boolean, required
  - `documents` DocumentResult[], required
    - `filename` string, required
    - `success` boolean, required
    - `data` object, nullable
    - `warnings` string[]
    - `error` string, nullable
    - `page_count` integer, nullable
  - `total_documents` integer, required
  - `successful` integer, required
  - `failed` integer, required
  - `skipped_files` string[]
  - `warnings` string[]
  - `duration_seconds` number, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zicron/apis/zicron-api.md) · [All operations](https://skmtc.dev/zicron/apis/zicron-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zicron/apis/zicron-api/revisions/abe62e22aa46?raw)