---
title: "Submit Claim Upload"
method: POST
path: "/api/v1/claims/upload/submit"
tags: ["Open API", "Claims Upload File Input Method"]
---

# Submit Claim Upload

`POST /api/v1/claims/upload/submit`

## Request

- Base URL: `https://developer.claimmind.life` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.claimmind.life/api/v1/claims/upload/submit`
- Auth: none declared. Required headers: `X-API-Key`

Submit a new claim with file uploads.

Upload medical documents directly as files. The service will:
- Validate file types and sizes
- Store files in the configured storage backend (GCS or local)
- Trigger the medical claim orchestrator workflow

**Metadata format (optional JSON string):**
```json
{
    "external_claim_id": "CLM-001",
    "payer_id": "bpjs",
    "patient": {"nama": "...", "rekam_medis": "..."},
    "admission": {"jenis_pasien": "Rawat Inap", "kelas_rawat": 1},
    "diagnosis": {"diagnosa_utama": "..."}
}
```

**Supported file types:** PDF, PNG, JPEG, TIFF
**Max file size:** 10MB per file

**Required scope:** `claims:write`

## Headers

- `X-API-Key` string, required

## Request body `multipart/form-data`

- BodySubmitClaimUploadApiV1ClaimsUploadSubmitPost
  - `files` string[], required: Medical documents (PDF, PNG, JPEG, TIFF)
  - `metadata` string: Optional JSON string of claim metadata

## Response `202`

Successful Response

- ClaimSubmitResponse: Claim submission response.
  - `claim_id` string, required
  - `external_claim_id` string, nullable
  - `workflow_id` string, required
  - `status` string, required
  - `status_url` string, required
  - `submitted_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/claimmind/apis/claimmind-open-api-service.md) - [All operations](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/revisions/ee8bfbeadb8a?raw)