---
title: "Create Claim"
method: POST
path: "/v1/claims"
tags: ["claims"]
---

# Create Claim

`POST /v1/claims`

## Request

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

Create a new claim.

Strangler shim over ``cases.create@1`` (capabilities/MIGRATION.md): the
capability runs the workflow, write gates, usage limits and intake triage.

## Request body

- CreateClaimRequest
  - `claim_type` 'wc' | 'ssdi' | 'ssi' | 'va' | 'pi' | 'ltd' | 'std' | 'feca' | 'sdi' | 'medicare' | 'medicaid' | 'hospice' | 'lnc', required: 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.
  - `context_fields` object: Claim-type-specific context fields

## Response `201`

Successful Response

- ClaimSummaryResponse
  - `id` string, required
  - `claim_type` string, required
  - `claimant_name` string, nullable
  - `person_id` string, nullable
  - `person_name` string, nullable
  - `document_count` integer, required
  - `has_inference` boolean, required
  - `overall_score` number, nullable: Case strength score, 0.0-1.0 (not a percentage). Deterministic rating of how well the evidence supports each evaluation step. Use it to rank and triage; it is NOT a probability of approval and has not been calibrated against claim outcomes.
  - `confidence` string, nullable
  - `gap_counts` object, nullable
  - `status` string
  - `lifecycle_stage` string
  - `disposition` string
  - `assigned_to` string, nullable
  - `next_deadline` string, nullable
  - `intake_tier` string, nullable
  - `lead_score` number, nullable
  - `completeness_p0_pct` number, nullable
  - `missing_p0` string[], nullable
  - `intake_recommendation` string, nullable
  - `flagged` boolean
  - `snoozed_until` string, nullable
  - `recent_contact` object, nullable
  - `submission_ready` boolean
  - `submission_blockers` string[], nullable
  - `created_at` string, required
  - `updated_at` string, 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)