# Insurance

Model ID: `Insurance`

A patient's insurance coverage, mapped to/from a FHIR Coverage resource.

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `copay` | `number|null` | No |  |  |  | Yes | Fixed copay amount, when known. |
| `deductible` | `number|null` | No |  |  |  | Yes | Plan deductible amount, when known. |
| `effective_date` | `string|null` | No |  |  |  | Yes | Date coverage begins. |
| `group_number` | `string|null` | No |  |  |  | Yes | Employer or plan group number, when applicable. |
| `member_id` | `string` | Yes |  |  |  | No | Subscriber's member/policy ID with the payer. |
| `payer_id` | `string|null` | No |  |  |  | Yes | NAIC or payer identifier |
| `payer_name` | `string` | Yes |  |  |  | No | Display name of the insurance payer/carrier. |
| `plan_name` | `string|null` | No |  |  |  | Yes | Display name of the specific insurance plan. |
| `plan_type` | `string|null` | No |  |  |  | Yes | HMO, PPO, EPO, POS, etc. |
| `priority` | [`InsurancePriority`](./InsurancePriority.md) | Yes |  |  |  | No | Coordination-of-benefits order: primary, secondary, or tertiary. |
| `subscriber_date_of_birth` | `string|null` | No |  |  |  | Yes | Subscriber's date of birth, when the patient is not the subscriber. |
| `subscriber_first_name` | `string|null` | No |  |  |  | Yes | Subscriber's first name, when the patient is not the subscriber. |
| `subscriber_id` | `string|null` | No |  |  |  | Yes | Subscriber's identifier, when different from member_id. |
| `subscriber_last_name` | `string|null` | No |  |  |  | Yes | Subscriber's last name, when the patient is not the subscriber. |
| `subscriber_relationship` | [`SubscriberRelationship`](./SubscriberRelationship.md) | No |  |  | `"self"` | No | Patient's relationship to the subscriber. |
| `termination_date` | `string|null` | No |  |  |  | Yes | Date coverage ends, when known; must be after effective_date. |

## Example

None declared in canonical OpenAPI.