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

# The Insurance Company Object

<Info>
  **API v2 covers billing data from the Elation EHR, not the Elation Billing product.**

  API v2 gives you access to billing information captured in the patient chart, such as [bills](/articles/rest/billing-api/bills/the-bill-object), [billing codes](/articles/rest/billing-api/billing-codes/the-billing-code-object), and [outstanding balance](/articles/rest/billing-api/outstanding-balance/update-outstanding-balance). Integrations typically use these endpoints to send visit charges from Elation to a third-party practice management system, and to surface patient balance information in the Elation EHR.

  Claims, payments, remittances, and patient statements belong to Elation Billing and aren't available through API v2. Practices using Elation Billing can query that data in the Hosted Database — see [Claim](/articles/hdb/claim), [Charge](/articles/hdb/charge), [Payment](/articles/hdb/payment), and [ERA Matched Adjustment](/articles/hdb/era-matched-adjustment).
</Info>

## Object Definition

```json theme={null}
{
  "id": 70850314606,                        // read-only
  "practice": 65540,                        // required
  "carrier": "Medicare",                    // string(200). required
  "address": "2093 Philadelphia Pike",      // string(200). optional
  "suite": "#2541",                         // string(35). nullable. optional
  "city": "Claymont",                       // string(50). optional
  "state": "DE",                            // string(2). optional
  "zip": "19703",                           // string(10). optional
  "phone": "(415) 231-5164",                // string(20). nullable. optional
  "extension": null,                        // string(6). nullable. optional
  "created_date": "2016-05-23T17:50:50Z",   // datetime(iso8601). read-only
  "deleted_date": null,                     // datetime(iso8601). read-only
  "patients": [123, 345],                   // read-only. only available when a single insurance company object is requested.
  "plans": [123, 345],                      // read-only. only available when a single insurance company object is requested.
  "payer_id": "4307",                       // string(200). nullable. optional. The Payer ID of the insurance carrier.
  "external_vendor_id": "UNI30",            // string(200). optional. nullable. The ID used by a vendor to represent the carrier in their system.
  "is_credentialed": true,                  // bool. optional. nullable. Whether or not the practice has credentials to submit claims to the carrier.
  "aliases": "BC, Blue C, BCross",          // string(300). optional. nullable. A string used to create alternate terms that will come up in search results (for example "BC" for Blue Cross).
  "insurance_type": "commercial"            // enum. optional. nullable. An enumerator representing the type of insurance the carrier offers.
}
```