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

# ClearCoverage API

> Retrieve enriched eligibility and benefits information via Vyne ClearCoverage with standardized, normalized data across 44+ dental carriers.

The ClearCoverage API provides enriched eligibility and benefits information from payers in real time via Vyne ClearCoverage. It returns standardized, normalized data relevant for dental use cases with deep benefit insights across 44+ supported carriers.

## SDK

```typescript theme={null}
const response = await client.clearCoverage.request({
  payer: { id: '52133' },
  provider: { npi: '1447364856', tax_id: '270872579' },
  subscriber: {
    dob: '01/15/1990',
    first_name: 'John',
    group_number: 'GRP001',
    last_name: 'Smith',
    member_id: '123456789',
  },
  version: 'v2',
});
```

## REST

**Endpoint:** `POST https://wg.api.dental/rest/ClearCoverage`

**Headers:**

* `X-Token-API: your-api-key`
* `Content-Type: application/json`

```json theme={null}
{
  "payer": { "id": "52133" },
  "provider": { "npi": "1447364856", "tax_id": "270872579" },
  "subscriber": {
    "first_name": "John",
    "last_name": "Smith",
    "member_id": "123456789",
    "dob": "01/15/1990",
    "group_number": "GRP001"
  },
  "version": "v2"
}
```

## GraphQL

**Endpoint:** `POST https://graphql.api.dental/gql`

```graphql theme={null}
mutation Eligibility_ClearCoverage {
  eligibility_ClearCoverage(
    payer: { id: "52133" }
    provider: { npi: "1447364856", tax_id: "270872579" }
    subscriber: {
      first_name: "John"
      last_name: "Smith"
      member_id: "123456789"
      dob: "01/15/1990"
      group_number: "GRP001"
    }
    version: "v2"
  )
}
```

## Request Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `payer.id` | string | Yes | ClearCoverage payer ID (see [supported carriers](#supported-carriers) below) |
| `provider.npi` | string | Yes | Provider's National Provider Identifier (10 digits) |
| `provider.tax_id` | string | Yes | Provider's Tax Identification Number (9 digits) |
| `subscriber.first_name` | string | Yes | Subscriber's first name |
| `subscriber.last_name` | string | Yes | Subscriber's last name |
| `subscriber.member_id` | string | Yes | Insurance member ID |
| `subscriber.dob` | string | Yes | Date of birth (MM/DD/YYYY) |
| `subscriber.group_number` | string | Yes | Insurance group number |
| `dependent` | object | No | Same fields as subscriber |
| `version` | string | Yes | API version — use `"v2"` |
| `location_id` | string | No | Optional location identifier |

## Error Responses

When the upstream payer service returns an error (e.g. invalid payer ID, bad subscriber data), the API passes through the full error details so you can diagnose and fix your request:

```json theme={null}
{
  "error": {
    "statusCode": 400,
    "message": "Invalid payer ID: INVALID_PAYER, please check https://developers.onederful.co/ for valid payer IDs",
    "upstream": {
      "message": "Invalid payer ID: INVALID_PAYER, please check https://developers.onederful.co/ for valid payer IDs",
      "code": "invalid_payer_id",
      "primaryReason": "Invalid payer ID"
    }
  }
}
```

| Field | Description |
| - | - |
| `statusCode` | HTTP status code from the upstream payer service |
| `message` | Human-readable error summary |
| `upstream` | Full error response body from the payer service (object or string) |

<Tip>
  ClearCoverage requests may take longer than standard eligibility queries. Consider setting a timeout of 120 seconds when using the SDK.
</Tip>

## Supported Carriers

ClearCoverage supports 44 carriers with detailed response levels. Use the Carrier ID as the `payer.id` value in your requests.

*Last Updated: 7/30/25*

| Carrier ID | Carrier Name | Response Level |
| - | - | - |
| `65978` | METLIFE | ClearCoverage / Detailed |
| `64246` | GUARDIAN LIFE INSURANCE CO | ClearCoverage / Detailed |
| `62308` | CIGNA | ClearCoverage / Detailed |
| `DELTA` | DELTA DENTAL OF MI | ClearCoverage / Detailed |
| `CX014` | DENTAQUEST (MEDICAID) | ClearCoverage / Detailed |
| `77777` | DELTA DENTAL OF CA | ClearCoverage / Detailed |
| `52133` | UNITED HEALTHCARE DENTAL | ClearCoverage / Detailed |
| `94276` | DELTA DENTAL OF DDIC | ClearCoverage / Detailed |
| `CX013` | UNITED CONCORDIA - Dental Plus | ClearCoverage / Detailed |
| `47009` | AMERITAS LIFE INSURANCE COMPANY | ClearCoverage / Detailed |
| `47598` | DELTA DENTAL OF IL (GROUP PLANS) | ClearCoverage / Detailed |
| `11198` | DELTA DENTAL OF NY | ClearCoverage / Detailed |
| `04614` | DELTA DENTAL OF MA | ClearCoverage / Detailed |
| `23166` | DELTA DENTAL OF PA | ClearCoverage / Detailed |
| `CDMN1` | DELTA DENTAL OF MN | ClearCoverage / Detailed |
| `CDCA1` | TRICARE RETIREE DENTAL | ClearCoverage / Detailed |
| `39069` | DELTA DENTAL OF WI | ClearCoverage / Detailed |
| `CDVA1` | DELTA DENTAL OF VA | ClearCoverage / Detailed |
| `22189` | DELTA DENTAL OF NJ | ClearCoverage / Detailed |
| `60054` | AETNA | ClearCoverage / Detailed |
| `DDAL1` | DELTA DENTAL OF ALABAMA | ClearCoverage / Detailed |
| `DDFL1` | DELTA DENTAL OF FLORIDA | ClearCoverage / Detailed |
| `DDLA1` | DELTA DENTAL OF LOUISIANA | ClearCoverage / Detailed |
| `DDMS1` | DELTA DENTAL OF MISSISSIPPI | ClearCoverage / Detailed |
| `DDMT1` | DELTA DENTAL OF MONTANA | ClearCoverage / Detailed |
| `DDNV1` | DELTA DENTAL OF NEVADA | ClearCoverage / Detailed |
| `DDTX1` | DELTA DENTAL OF TEXAS | ClearCoverage / Detailed |
| `DDUT1` | DELTA DENTAL OF UTAH | ClearCoverage / Detailed |
| `66043` | DELTA DENTAL OF PUERTO RICO | ClearCoverage / Detailed |
| `31096` | DELTA DENTAL OF WEST VIRGINIA | ClearCoverage / Detailed |
| `52147` | DELTA DENTAL OF DISTRICT OF COLUMBIA | ClearCoverage / Detailed |
| `DDMD1` | DELTA DENTAL OF MARYLAND | ClearCoverage / Detailed |
| `51022` | DELTA DENTAL OF DELAWARE | ClearCoverage / Detailed |
| `52147` | DELTA DENTAL OF WASHINGTON | ClearCoverage / Detailed |

<Info>
  This carrier list is provided for convenience and is subject to change. For the most current list, contact [support@api.dental](mailto:support@api.dental).

  © 2025 Napa EA/MEDX LLC. All rights reserved.
</Info>