---
updatedAt: 2026-10-13T21:50:58.000Z
agentTools:
  projectIndex: https://docs.nexhealth.com/llms.txt
---

# Insurance

## Before you start

* NexHealth reads financial data from the health record system only on request. To turn it on for your API key, email <developers@nexhealth.com>. Sandbox locations have it on.
* Every request needs a bearer token from `POST /authenticates`. See [Authentication](https://docs.nexhealth.com/reference/authentication-1).
* Requests take the practice's `subdomain` and, for most endpoints, a `location_id`. See [Institutions, syncs, and locations](https://docs.nexhealth.com/docs/institutions-syncs-and-locations).

## Overview

The insurance endpoints let you read the insurance information tied to a practice and its patients. There are two related resources:

* **Insurance plans** (`/insurance_plans`, `/insurance_plans/{id}`) hold general information about an insurance policy: payer ID, group number, employer name and carrier address. A plan represents the policy itself, independent of any one patient.
* **Insurance coverages** (`/insurance_coverages`, `/insurance_coverages/{id}`) connect a patient to an insurance plan. A coverage holds patient-specific details: the subscriber number, the patient's relationship to the subscriber (`subscription_relation`), coverage priority, and effective and expiration dates. A patient can have more than one active coverage, for example primary and secondary.

To fetch a single plan with its `patient_coverages`, `subscribers` and `fee_schedule`, pass them in the `include` parameter. Coverages return only active records by default. Pass `active=false` to list inactive ones.

## Example use cases

* Show patients which insurance plans and coverages are on file in a patient portal, so they can confirm their information is current before an appointment.
* Give front-desk staff a patient's active coverages and plan details before a visit, so they can confirm insurance without opening the health record system.

# Sub pages

* [View insurance plans](https://docs.nexhealth.com/reference/getinsuranceplans.md)
* [View insurance plan](https://docs.nexhealth.com/reference/getinsuranceplansid.md)
* [View insurance coverages](https://docs.nexhealth.com/reference/getinsurancecoverages.md)
* [View insurance coverage](https://docs.nexhealth.com/reference/getinsurancecoveragesid.md)

# Sibling pages

* [Adjustments](https://docs.nexhealth.com/reference/adjustments.md)
* [Adjustment types](https://docs.nexhealth.com/reference/adjustment-types.md)
* [Fee schedules](https://docs.nexhealth.com/reference/fee-schedules.md)
* [Payment plans](https://docs.nexhealth.com/reference/payment-plans.md)
* [Payment types](https://docs.nexhealth.com/reference/payment-types.md)
* [Balances](https://docs.nexhealth.com/reference/balances.md)
* [Charges](https://docs.nexhealth.com/reference/charges.md)
* [Claims](https://docs.nexhealth.com/reference/claims.md)
* [Payments](https://docs.nexhealth.com/reference/payments.md)