---
title: "Create Referral"
method: POST
path: "/v1/api/referrals"
tags: ["referrals"]
---

# Create Referral

`POST /v1/api/referrals`

## Request

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

Accept a B2B referral with metadata and optional document files.

Returns 202 Accepted with a batch_id for tracking processing status.

## Response `202`

Successful Response

- ReferralAcceptedResponse
  - `referral_id` string, required
  - `claim_id` string, required
  - `batch_id` string, required
  - `documents_queued` integer, required
  - `status_url` 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)