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

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

{
  "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

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 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:

{
  "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)

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

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

This carrier list is provided for convenience and is subject to change. For the most current list, contact [e-mail].

© 2025 Napa EA/MEDX LLC. All rights reserved.