> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Health plans

> How health-plan referrals appear on GET and webhooks, and how to track them to the report

This guide is for **health plans**. It covers how Scan labels those referrals
when you read them back — not a separate create body.

Before using this guide you need a sandbox and an access token. Request keys from
[Get API keys](https://admin.staging.scan.com/partner/api_access). How to send
`Authorization` is in [Authentication](/authentication). Use synthetic data only
on the initial sandbox. Listing imaging centers, searching or creating practices or
law firms, and submitting an order-form-only referral may be off until Scan enables
them for your account.

## Create

`POST /api/v2/referrals` does **not** set `line_of_business: health_plan` today.
The create endpoint does not currently accept member-ID or payer-ID fields.
Send only fields documented in
[Creates a referral](/api-reference/referrals/creates-a-referral). Scan may
enable a dedicated health-plan create schema in the future.

To submit imaging in the meantime, use
[Submit a medical referral](/guides/submit-a-medical-referral). Optional add-ons:
[Submit medical questions](/guides/submit-medical-questions) and
[Submit preferred times](/guides/submit-preferred-times). Full intake:
[Submit for scheduling](/guides/submit-for-scheduling).

## Identify a health-plan referral

On [`GET /api/v2/referrals/{referral_id}`](/api-reference/referrals/returns-a-referral-by-id)
and on the [status changed webhook](/webhooks/status-changed) nested referral:

| Field              | Health plan                |
| ------------------ | -------------------------- |
| `line_of_business` | `health_plan`              |
| `payor`            | Present (`id`, `name`)     |
| `insurance_number` | Member number when on file |
| `wc_number`        | Omitted                    |

## Status changes

Every status, what it means, and how changes reach you are on
[Track referral status](/guides/track-referral-status).

One thing is specific to health plans: a visit sits in `pending_auth` while
coverage is reviewed, which can delay booking. Do not poll for the internal
steps in between — wait for the next webhook or take a snapshot when you need
one.