Vericred API

API Endpoint
https://api.vericred.com

Getting Started

Signing Up

Visit our Developer Portal to create an account.

Once you have created an account, you can create one Application for your Production environment and another for a Sandbox (select the appropriate Plan when you create the Application).

SDKs

Our API follows standard REST conventions, so you can use any HTTP client to integrate with us. You will likely find it easier to use one of our autogenerated SDKs, which we make available for several common programming languages.

Authentication

To authenticate, pass the API Key you created in the Developer Portal as a Vericred-Api-Key header.

curl -H 'Vericred-Api-Key: YOUR_KEY' "https://api.vericred.com/drugs?search_term=Lipitor"

Versioning

Vericred’s API default to the latest version. However, if you need a specific version, you can request it with an Accept-Version header.

The current version is v6. We support prior versions. Our latest stable version is v7 and we will indicate in the documentation for an endpoint if it’s required.

curl -H 'Vericred-Api-Key: YOUR_KEY' -H 'Accept-Version: v6' "https://api.vericred.com/drugs?search_term=Lipitor"

Pagination

Endpoints that accept page and per_page parameters are paginated. They expose four additional fields that contain data about your position in the response, namely Total, Per-Page, Link, and Page as described in RFC-5988.

For example, to display 5 results per page and view the second page of a GET to /networks, your final request would be GET /networks?....page=2&per_page=5.

Sideloading

When we return multiple levels of an object graph (e.g. Providers and their States we typically the associated data. In this example, we would provide an Array of States and a state_id for each provider. This is done primarily to reduce the payload size since many of the Providers will share a State

Simplified Example

{
  providers: [{ id: 1, state_id: 1}, { id: 2, state_id: 1 }],
  states: [{ id: 1, code: 'NY' }]
}

If you need the second level of the object graph, you can just match the corresponding id.

Selecting specific data

All endpoints allow you to specify which fields you would like to return. This allows you to limit the response to contain only the data you need.

For example, let’s take a request that returns the following JSON by default

{
  provider: {
    id: 1,
    name: 'John',
    phone: '1234567890',
    field_we_dont_care_about: 'value_we_dont_care_about'
  },
  states: [{
    id: 1,
    name: 'New York',
    code: 'NY',
    field_we_dont_care_about: 'value_we_dont_care_about'
  }]
}

To limit our results to only return the fields we care about, we specify the select in the query string for a GET or the body for a POST.

In this case, we want to select name and phone from the provider key, so we would add the parameters select=provider.name,provider.phone. We also want the name and code from the states key, so we would add the parameters select=states.name,states.code. The id field of each document is always returned whether or not it is requested.

Our final request would be GET /providers/1234567898?select=provider.name,provider.phone,states.name,states.code

The response would be

{
  provider: {
    id: 1234567898,
    name: 'John',
    phone: '1234567890'
  },
  states: [{
    id: 1,
    name: 'New York',
    code: 'NY'
  }]
}

Plan and Rate Data

Vericred’s Plan and Rate Data let you search and quote Major Medical and Ancillary Insurance Plans in a given area for a particular family in the Individual Market or a group of families in the Small Group Market. Vericred provides the relevant data via this API and via our Bulk Format (documented [below](#Bulk Plan and Rate Data))

Plans

A Plan defines a set of Benefits available to its purchaser. For example, a Major Medical Plan would specify cost-share Benefits for services like a Primary Care Provider visit, a Specialist visit or an Emergency Room visit. A Dental Plan might specify Benefits for Periodontics and Fluroride Treatments. The Benefits for each Product type (Major Medical, Dental, and Vision) are documented below.

Benefits Format

Benefits for Plans can be quite complex. With the goals of capturing and standardizing the complexity while retaining a human-readable format, we have developed a Bakus-Naur Form(BNF) context-free grammar, with which we present Benefits.

Benefit cost-share strings are formatted to capture:

  • Network tiers

  • Compound or conditional cost-share

  • Limits on the cost-share

  • Benefit-specific maximum out-of-pocket costs

Example #1 As an example, we would represent this Summary of Benefits & Coverage as:

  • Hospital stay facility fees:

    • Network Provider: $400 copay/admit plus 20% coinsurance
    • Out-of-Network Provider: $1,500 copay/admit plus 50% coinsurance
    • Vericred’s format for this benefit: In-Network: $400 before deductible then 20% after deductible / Out-of-Network: $1,500 before deductible then 50% after deductible
  • Rehabilitation services:

    • Network Provider: 20% coinsurance
    • Out-of-Network Provider: 50% coinsurance
    • Limitations & Exceptions: 35 visit maximum per benefit period combined with Chiropractic care.
    • Vericred’s format for this benefit: In-Network: 20% after deductible / Out-of-Network: 50% after deductible | limit: 35 visit(s) per Benefit Period

Example #2 In this other Summary of Benefits & Coverage, the specialty_drugs cost-share has a maximum out-of-pocket for in-network pharmacies.

  • Specialty drugs:
    • Network Provider: 40% coinsurance up to a $500 maximum for up to a 30 day supply
    • Out-of-Network Provider Not covered
    • Vericred’s format for this benefit: In-Network: 40% after deductible, up to $500 per script / Out-of-Network: 100%

BNF

Here’s a description of the benefits summary string, represented as a context-free grammar:

root                      ::= coverage

coverage                  ::= (simple_coverage | tiered_coverage) (space pipe space coverage_modifier)?
tiered_coverage           ::= tier (space slash space tier)*
tier                      ::= tier_name colon space (tier_coverage | not_applicable)
tier_coverage             ::= simple_coverage (space (then | or | and) space simple_coverage)* tier_limitation?
simple_coverage           ::= (pre_coverage_limitation space)? coverage_amount (space post_coverage_limitation)? (comma? space coverage_condition)?
coverage_modifier         ::= limit_condition colon space (((simple_coverage | simple_limitation) (semicolon space see_carrier_documentation)?) | see_carrier_documentation | waived_if_admitted | shared_across_tiers)
waived_if_admitted        ::= ("copay" space)? "waived if admitted"
simple_limitation         ::= pre_coverage_limitation space "copay applies"
tier_name                 ::= "In-Network-Tier-2" | "Out-of-Network" | "In-Network"
limit_condition           ::= "limit" | "condition"
tier_limitation           ::= comma space "up to" space (currency | (integer space time_unit plural?)) (space post_coverage_limitation)?
coverage_amount           ::= currency | unlimited | included | unknown | percentage | (digits space (treatment_unit | time_unit) plural?)
pre_coverage_limitation   ::= first space digits space time_unit plural?
post_coverage_limitation  ::= (((then space currency) | "per condition") space)? "per" space (treatment_unit | (integer space time_unit) | time_unit) plural?
coverage_condition        ::= ("before deductible" | "after deductible" | "penalty" | allowance | "in-state" | "out-of-state") (space allowance)?
allowance                 ::= upto_allowance | after_allowance
upto_allowance            ::= "up to" space (currency space)? "allowance"
after_allowance           ::= "after" space (currency space)? "allowance"
see_carrier_documentation ::= "see carrier documentation for more information"
shared_across_tiers       ::= "shared across all tiers"
unknown                   ::= "unknown"
unlimited                 ::= /[uU]nlimited/
included                  ::= /[iI]ncluded in [mM]edical/
time_unit                 ::= /[hH]our/ | (((/[cC]alendar/ | /[cC]ontract/) space)? /[yY]ear/) | /[mM]onth/ | /[dD]ay/ | /[wW]eek/ | /[vV]isit/ | /[lL]ifetime/ | ((((/[bB]enefit/ plural?) | /[eE]ligibility/) space)? /[pP]eriod/)
treatment_unit            ::= /[pP]erson/ | /[gG]roup/ | /[cC]ondition/ | /[sS]cript/ | /[vV]isit/ | /[eE]xam/ | /[iI]tem/ | /[sS]tay/ | /[tT]reatment/ | /[aA]dmission/ | /[eE]pisode/
comma                     ::= ","
colon                     ::= ":"
semicolon                 ::= ";"
pipe                      ::= "|"
slash                     ::= "/"
plural                    ::= "(s)" | "s"
then                      ::= "then" | ("," space) | space
or                        ::= "or"
and                       ::= "and"
not_applicable            ::= "Not Applicable" | "N/A" | "NA"
first                     ::= "first"
currency                  ::= "$" number
percentage                ::= number "%"
number                    ::= float | integer
float                     ::= digits "." digits
integer                   ::= /[0-9]/+ (comma_int | under_int)*
comma_int                 ::= ("," /[0-9]/*3) !"_"
under_int                 ::= ("_" /[0-9]/*3) !","
digits                    ::= /[0-9]/+ ("_" /[0-9]/+)*
space                     ::= /[ \t]/+

Major Medical

Vericred’s data covers all Major Medical Plans available in the Individual and Small Groups (2-50 or 2-100) Markets in the US. These Plans are governed by CMS and are ACA-compliant. We do not include certain Plans that fall outside of the ACA, for example, Faith-Based Plans or Short-Term Medical Plans

We support the following Benefits Fields for Major Medical Plans. These represent the vast majority of fields available on a Summary of Benefits and Coverage

The following are the appropriate Benefit Fields for Major Medical:

  • ambulance

  • child_eye_exam

  • child_eyewear

  • chiropractic_services

  • diagnostic_test

  • durable_medical_equipment

  • emergency_room

  • family_drug_deductible

  • family_drug_moop

  • family_medical_deductible

  • family_medical_moop

  • generic_drugs

  • habilitation_services

  • home_health_care

  • hospice_service

  • imaging_center

  • imaging_physician

  • individual_drug_deductible

  • individual_drug_moop

  • individual_medical_deductible

  • individual_medical_moop

  • inpatient_birth

  • inpatient_birth_physician

  • inpatient_facility

  • inpatient_mental_health

  • inpatient_physician

  • inpatient_substance

  • lab_test

  • non_preferred_brand_drugs

  • nonpreferred_generic_drug_share

  • nonpreferred_specialty_drug_share

  • outpatient_ambulatory_care_center

  • outpatient_facility

  • outpatient_mental_health

  • outpatient_physician

  • outpatient_substance

  • plan_coinsurance

  • postnatal_care

  • preferred_brand_drugs

  • prenatal_care

  • preventative_care

  • primary_care_physician

  • rehabilitation_services

  • skilled_nursing

  • specialist

  • specialty_drugs

  • telemedicine

  • urgent_care

Dental

Dental benefits are less standardized than Major Medical. Because of this, we have captured benefits for the most commonly specified services and procedures. If a Plan only specifies cost-share for “Major”, “Minor”, “Elective”, etc, we determine the category for each of the benefits that we support and display the appropriate value for its category.

To view the technical documentation, click here.

The following are the supported Benefit Fields for Dental:

  • bridges

  • crowns

  • denture_relines_rebases

  • denture_repair_and_adjustments

  • dentures

  • emergency_treatment

  • endodontics

  • family_annual_max

  • family_deductible

  • fluoride_treatment

  • implants

  • individual_annual_max

  • individual_deductible

  • inlays

  • onlays

  • oral_exam

  • oral_surgery

  • orthodontics_adult

  • orthodontics_child

  • periodontal_maintenance

  • periodontics

  • prophylaxis_cleaning

  • radiograph_bitewings

  • radiograph_other

  • restoration_fillings

  • sealant

  • simple_extraction

  • space_maintainers

Vision

Vision benefits are similar in structure to Dental. Again, when benefits are broken out by category, we determine the appropriate category for each service or procedure and display the approprate value for its category.

To view the technical documentation, click here.

The following are the supported Benefit Fields for Vision:

  • eye_exam

  • retinal_imaging

  • frame

  • eyeglass_lenses_single_vision

  • eyeglass_lenses_bifocal

  • eyeglass_lenses_trifocal

  • eyeglass_lenses_lenticular

  • uv_coating

  • tint

  • standard_antireflective_coating

  • premium_antireflective_coating

  • standard_polycarbonate_lenses_child

  • standard_polycarbonate_lenses_adult

  • standard_progressive_lenses

  • premium_progressive_lenses

  • standard_scratch_resistance

  • polarized_lenses

  • photochromatic_lenses

  • standard_contact_lens_fit_and_follow_up

  • premium_contact_lens_fit_and_follow_up

  • contact_lenses_conventional

  • contact_lenses_disposable

  • contact_lenses_medically_necessary

  • laser_vision_correction

  • additional_pairs_of_eyeglasses

Medicare Advantage

Medicare Advantage endpoints support MA (Medicare Advantage plans without prescription drug benefits), MAPD (Medicare Advantage plans with prescription drug benefits), and PDP (prescription drug benefits only) plans.

Medical and hospital benefits - we support over 4000 individual plans through our API nationwide. At this time, we do not support EGHP (employer group health plans).

Prescription drug benefits - drug benefits are categorized into initial coverage phase, coverage gap phase, and catastrophic phase. Each phase is broken down by drug tiers, pharmacy tiers, and length of supply.

Click here to learn more about quoting Medicare Advantage plans.

Rates

Rates are returned from the API as a part of Quoting. We calculate Rates in one of two ways.

Sheet Rates

When a Carrier supplies us with Sheet Rates, we display exactly the value provided to us. For example, in the Major Medical market, most Carriers provide a single rate for each combination of Applicant age and tobacco status in a given Rating Area. For example, in Austin, TX, a 21-year-old non-tobacco-user may be $312.41 per month while a 22-year-old tobacco-user may be $401.75 per month. Certain Vision and Dental Carriers supply Sheet Rates as well, though it is less common.

Rate Factors

Certain Major Medical Carriers and most Vision and Dental Carriers supply Rate Factors. The attributes on which the factors are based are the same as Sheet Rates for the Major Medical market (due to restrictions on what factors may be used in ACA Plans, which limit the possible factors to age and tobacco status).

In Dental and Vision, the types of Rate Factors are more varied. For example, SIC Code and Group size in the Group market and Gender in the Individual Market are commonly used Rate Factors

Other common Rate Factors for Dental and Vision products are Geographic and “Trend” (enrollment date) Factors. In Major Medical, these types of variance are handled by CMS-defined Rating Areas.

In order to calculate a Rate using Rate Factors, the following methodology is applied:

B = Base Rate
f = Rate Factor Function 1
f' = Rate Factor Function 2

B * f(x) * f'(y) [* f''(z)] ... = n

Rating Areas

For Major Medical products, CMS defines Rating Areas. Under the ACA, all Rate Factors in a Rating Area must be identical for a given time period. E.g. in Arizona, the rate for a 21-year-old non-tobacco user must be identical in all counties contained in Rating Area 1 (Mohave, Coconino, Apache, and Navajo), but may be different than the rate for a 21-year-old non-tobacco user in all counties Rating Area 2 (Yavapai county only) for a given year in the Individual Market and a given quartern in the Small Group market.

Rating Areas are defined either by County, Zip Code or both, depending on the State. Because of this variance, all API endpoints that require a Location require both zip_code and fips_code (a county code). Bulk Data for Rating Areas and Service Areas also specifies locations using both zip_code and fips_code.

Rating Areas do not apply to products other than Major Medical

Service Areas

CMS mandates that Major Medical Rates be defined by Rating Areas, which themselves define a geography in which Plans are offered. Carriers often choose not to offer a Plan in and entire Rating Area due to network coverage or other factors. Instead, the Carrier would define a Service Area that specifies where a given Plan is offered.

Each Plan is available in a single Service Area and each Service Area is defined by either County, Zip Code, or both, depending on the Carrier. Because of this variance, all API endpoints that require a Location require both zip_code and fips_code (a county code). Bulk Data for Rating Areas and Service Areas also specifies locations using both zip_code and fips_code.

In Dental and Vision plans, we use a Service Area to define availability as well, although it typically mirrors a Geographic Rate Factor.

Quoting

One of the primary use-cases for the Vericred API is to run Quotes to determine the Rate for a given family (in the Individual Market) or group (in the Small Group Market). We support quoting across Major Medical, Vision, and Dental. In both cases, the process of generating a Quote is broken out into several steps:

  1. Find all available Plans in the relevent Service Areas for the family or group.

  2. Using Business Rules for each Plan, determine if the family or group is eligible for that Plan.

  3. Using Business Rules for each Plan, determine which members of the family or which members of each family in the group should be considered for Rating.

  4. Using the Sheet Rates or Rate Factors for each Plan, determine the Rate the family, or for each family in the group.

  5. If running a Composite quote, determine the portion of the total Rate that each family will pay.

Individual Quotes

An Individual Quote is one for Plans that are available to a particular family, outside the context of their Employer. In the Major Medical market, many of these Plans are available on Healthcare.gov or the State-Based Exchange for non-Healthcare.gov states. The API supports both on-market and off-market Plans.

For details on Major Medical Quoting API calls see below

Specifying the Location

In order to determine which plans are available and the rate for each Plan, you must specify a location. When creating a Quote for the Individual Market, that information is contained in the POST body of the request:

POST /plans/medical/search
{
  ...
  "zip_code": "11201",
  "fips_code": "36047"
  ...
}

Specifying Applicants

Applicants are the members of the family being quoted and are specified in the POST body of the request.

POST /plans/medical/search
{
  ...
  "applicants": [
    {
      "age": 34,
      "smoker": true,
      "child": false
    },
    {
      "age": 32,
      "smoker": false,
      "child": false
    },
    {
      "age": 4,
      "smoker": false,
      "child": true
    }
  ]
  ...
}

Specifying Enrollment Date

The enrollment_date determines which Plans and Rates are returned. Specifying an enrollment_date in the past allows you to calculate historical data as far back as 2014.

Plan Benefits

Plan Benefits are returned in the response for Individual Quotes

POST /plans/medical/search
{
  ...
}

Response:
{
  "plans": [
    {
      ...
      "individual_medical_deductible": "$5,000",
      "family_medical_deductible": "$10,000"
      ...
    }

  ]
}

Premiums

The value for the family being quoted is returned in the premium field. If no Applicants are provided, the premium field will be 0

Major Medical Quotes

In order to Quote Major Medical Plans, send a POST to /plans/medical/search. In addition, the age, smoker and child attributes of each Applicant must be present.

Subsidies

On-market (Healthcare.gov and State-Based Exchange) Major Medical Plans are eligible for government subsidies. The subsidy calculation is based on the percentage of the family’s income that the IRS has designated as “affordable” for that family and the Second Lowest-Cost Silver Plan available to that family.

In order to calculate subsidies for a family the following parameters must be supplied:

POST /plans/medical/search
{
  ...
  "household_size": 4,
  "household_income": 40000
  ...
}

The amount that the family will pay after subsidy is returned in the premium_subsidized field for each plan.

Subsidy Calculation

Here is how subsidies are calculated. This is fully handled by the Vericred API, but the steps are enumerated below for clarity.

  1. Determine the percentage of the Federal Poverty Level for the family based on the household size and income.

  2. Reference the CMS table to determine the appropriate percentage of income for the family to spend on healthcare.

  3. Multiply that value by the family’s income. This is the total amount that the family can spend on healthcare for the year, after the subsidy.

  4. Find the cost of the Second Least-Expensive Silver Plan available to the family, accounting for the percentage of premium that goes to Essential Health Benefits

  5. Calculate the difference in price between the amount the family should spend on healthcare and the Second Least-Expensive Silver Plan’s premium. This is the subsidy.

  6. Apply the subsidy to all on-market Plans available to the family. The subsidized premium can never be below $0 (for example, a low-cost Bronze Plan may be less expensive than the subsidy)

Cost Sharing Reduction Plans

Cost Sharing Reduction (CSR) Plans are available to lower income families and offer enhanced benefits for certain Silver Plans at the same cost as the non-CSR Plans available to higher-income families.

If a family is eligible for CSR Plans, the Vericred API will return the relevant Plan in place of the non-CSR version.

In order to include CSR Plans where applicable, the following parameters must be supplied:

POST /plans/medical/search
{
  ...
  "household_size": 4,
  "household_income": 40000
  ...
}

The Children’s Health Insurance Program (CHIP)

The Children’s Health Insurance Program (CHIP) provides low-cost health coverage to children in families that earn too much money to qualify for Medicaid.

If a family is eligible for CHIP, the Vericred API will include the subsidy in the returned premiums. In order to include CHIP subsidies in premium calculations, the following parameters must be supplied:

POST /plans/medical/search
{
  ...
  "applicants": [
    {
      "age": 34,
      "smoker": true,
      "child": false
    },
    {
      "age": 32,
      "smoker": false,
      "child": false
    },
    {
      "age": 4,
      "smoker": false,
      "child": true
    },
    {
      "age": 4,
      "smoker": false,
      "child": true
    }
  ],
  "household_size": 4,
  "household_income": 40000
  ...
}

CHIP eligibility is displayed within the meta-tag in the response as eligible_for_chip_medicaid:

{
  "meta": {
      "total": 150,
      "eligible_for_chip_medicaid": true,
      "premium_tax_credit": 500.20
    },
  "coverages": [],
  "plans": [...]
}

If you do not want CHIP subsidies to be included in the premiums, simply do not include the household_income parameter in the request.

Dental Quotes

Quoting Dental Plans for a family requires slightly different parameters for Applicants, due to the method with which Plans are rated. The folloiwng example contains the require parameters:

POST /plans/dental/search
{
  ...
  "applicants": [
    {
      "age": 34,
      "gender": "M",
      "child": false
    },
    {
      "age": 32,
      "gender": "F",
      "child": false
    },
    {
      "age": 4,
      "gender": "M",
      "child": true
    }
  ]
  ...
}

Note that in contrast to Major Medical Quotes, Dental Quotes require gender, but do not require smoker.

Also note that Subsidies and Cost Sharing Reduction are not relevant for Dental Quotes.

Vision Quotes

Quoting Vision Plans for a family requires slightly different parameters for Applicants, due to the method with which Plans are rated. The folloiwng example contains the require parameters:

POST /plans/vision/search
{
  ...
  "applicants": [
    {
      "age": 34,
      "gender": "M",
      "child": false
    },
    {
      "age": 32,
      "gender": "F",
      "child": false
    },
    {
      "age": 4,
      "gender": "M",
      "child": true
    }
  ]
  ...
}

Note that in contrast to Major Medical Quotes, Vision Quotes require gender, but do not require smoker.

Also note that Subsidies and Cost Sharing Reduction are not relevant for Vision Quotes.

Medicare Advantage quotes

Given an enrollment date and location, you can search all plans available at this location using /plans/medadv/search; you can also search a specific plan using its plan ID with /plans/medadv/{plan_id} if the plan ID is already known. The following example contains the required parameters:

{
"zip_code": "02880",
"fips_code": "44009",
"enrollment_date": "2019-01-01"
}

To view the technical documentation, click here.

Quotes for Groups

A Group Quote finds Plans and Rates for a group of employees for a small business. Different Plans are available to small groups than are available in Individual Quoting. In addition, Business Rules that apply across multiple families or based upon employer attributes such as SIC code factor into rates and availability.

In addition, due to performance requirements and for enhanced auditing, Group Quotes are persisted across requests. This means that a given Quote can be retrieved after it has been created.

Identifiers

In order to make it easier to cross-reference local copies of data with Quotes and other data in the Vericred API, most entities allow for the specification of an external_id field. You can use this to store a primary or natural key from your system in order to easily match records returned from the API with records in your system.

Specifying the Group

Creating a group is the first step in Group Quoting. The API requires that certain information such as sic_code, and chamber_association be provided and returns a the attributes and id for the newly created Group

Full documentation is available below

Specifying the Locations

When creating a Group, you must also specify one or more Locations. Of those Locations specified, one must be primary. That Location is used to calculate Plan eligibility using the relevant Service Areas. Some Carriers use secondary Locations to determine eligibility as well, which is why those must be specified as well.

POST /groups
{
  "group": {
    ...
  },
  "locations": [
    {
      ...
      "zip_code": "11201",
      "fips_code": "36047",
      "primary": true
      ...
    }
  ]
}

Specifying the Census

A Census is the collection of Members contained in the Group. The attributes of each Member and his or her Dependents determine the Rate for the Group as a whole. Certain attributes of the Member are important for calculating Rates and applying Business Rules. For example, the Member's home address and in which office he or she works are relevant for certain Business Rules.

Dependent Relationships

The Dependents for a given Member also factor into the Rates and application of Business Rules. For example, certain Plans cover only Dependents of particular types and/or only Dependents of a particular type who live in the same household as the primary Member

Valid Dependent Relationships:

  • adopted_child

  • child

  • court_appointed_guardian

  • dependent_of_dependent

  • ex_spouse

  • foster_child

  • grand_child

  • guardian

  • life_partner

  • other

  • sibling

  • sponsored_dependent

  • spouse

  • step_child

  • ward

POST

/groups/{id}/members
{
  "members": [
    ...
    {
      "cobra": false,
      "date_of_birth": "1980-01-01",
      "fips_code": "36047"
      "gender": "M",
      "last_used_tobacco": "2017-01-01",
      "location_id": :location_id
      "retiree": false,
      "zip_code": "11201",
      "dependents": [
        ...
        {
          "relationship": "child",
          "same_household": true
        }
        ...
      ]
    }
    ...
  ]
}

Creating a Quote

Once the Census has been created, we can generate a Quote for the Group.

Major Medical Quotes

To generate a Major Medical Quote, specify the product_line of Quote as medical

POST /groups/{id}/quotes
{
  ...
  "product_line": "medical"
  ...
}

Dental Quotes

To generate a Dental Quote, specify the product_line of Quote as dental

POST /groups/{id}/quotes
{
  ...
  "product_line": "dental"
  ...
}

Vision Quotes

To generate a Vision Quote, specify the product_line of Quote as vision

POST /groups/{id}/quotes
{
  ...
  "product_line": "vision"
  ...
}

Retrieving Aggregate Rates

Once you have created a Quote, you can retrieve its aggregate Rates. Rates are broken down by Member and Dependent, so that you can show the final cost in different scenarios where an employer might cover a different percentage of Member and Dependent costs.

GET /quotes/{id}/rates

Response
{
  "rates": [
    ...
    {
      "id": "123abc",
      "plan_id": "12345NY6789012",
      "total_premium": "2800.00",
      "member_premium": "1000.00",
      "dependent_premium": "1800.00",
      "premiums": {
        "age_banded": {
          "total_member": "1000.00",
          "total_dependent": "1800.00",
          "total": "2800.00"
        },
        "2_tier_composite": {
        "employee_only": "200.00",
        "employee_plus_family": "400.00",
        "total": "2800.00"
        },
        "3_tier_composite": {
          "employee_only": "200.00",
          "employee_plus_one": "250.00",
          "employee_plus_family": "330.00",
          "total": "2800.00"
        },
        "4_tier_composite": {
          "employee_only": "200.00",
          "employee_plus_child": "220.00",
          "employee_plus_spouse": "250.00",
          "employee_plus_family": "330.00",
          "total": "2800.00"
        }
      }
    }
    ...
  ]
}

Loading Plan Data

Aggregate Rates responses do not include Plan details in order to keep the payload small. Plan data can be retrieved in one of two ways:

Loading the Plan from the API:

GET /plans/{id}

Response:
{
  "plans": [
    ...
    {
      ...
      "individual_medical_deductible": "$5,000",
      "family_medical_deductible": "$10,000",
      ...
    }
    ...

  ]
}

Pulling in Bulk Plan Data and matching up Plans by their id.

Retrieving Member-Level Rates

In order to retrieve the exact Rate for each Member and their Dependents for given Plan, you can load Member-Level Rates.

GET /rates/{id}/member_rates

Response
{
  "member_rates": [
  ...
  {
    "id": "123abc",
    "member_id": "234def",
    "member_external_id": "externally-supplied-id",
    "member_premium": 500.0,
    "dependent_premium": 600.0,
    "total_premium": 1100.0
  }
  ...
  ]
}

Note that all MemberRates are for one particular Plan - the one referenced by the parent Rate.

Business Rules

Vericred works with our Carrier partners to acquire and apply Business Rules that can affect either Plan availability or the way in which Members and Dependents are rated. For example, one Carrier’s Business Rules might specify that Members and Dependents who have used tobacco in the past 4 months are considered “tobacco-users”, while another’s may specify that period to be 1 year.

These rules are applied transparently during the Quoting process and do not require any additional action or input on your part.

For a full accounting of Business Rules and a list of Carriers whose Business Rules are applied, please contact support@vericred.com

Composite Rates

Composite Rates are commonly used in Major Medical, Dental, and Vision Plans to simplify operations by charging each family the weighted average of the Group's total premium. The most common methodology is as follows:

  1. Calculate the Rates for the entire Group using Sheet Rates or Rate Factors as appropriate

  2. Categorize each Family within the Group. The categorization differs depending on whether the Composite Rate is 2, 3, or 4-tier

  3. Multiply the number of Families in each category by the constant for that category. These constants are provided to Vericred by the Carrier. This determines the total number of “Rating Units”

  4. Divide the total premium calculated in Step 1 by the total number of Rating Units to get the price per Rating Unit

  5. The Rate each Family pays is the constant for that Family’s category multiplied by the price per Rating Unit.

You can request that a Quote be calculated using Composite Rates when creating it:

POST /quotes
{
  ...
  "rating_method": "4_tier_composite"
  ...
}

If no Composite Rates methodology is available, the Vericred API will return standard age-banded Rates.

Network and Provider Data

A Provider is an individual or organization in the medical profession. For example, an individual doctor is a Provider as are certain clinics and hospitals.

Providers are related to Networks. A Network is a collection of Providers that are under a particular contract with a given Carrier. A given Carrier will often have multiple Networks. For example, there may be a large national Network as well as several smaller regional Networks.

Each Plan has a Network. A consumer who visits a Provider typically incurs fewer costs when visiting a Provider in the Network covered by his or her Plan. The premium for a Plan is often proportional to the size of its Network

Finding Providers

In order to determine if a particular Plan covers a given Provider, you must first identify the Provider. To do so, use the Provider Search API endpoint and specify some search criteria:

POST /providers/search
{
  "search_term": "foo",
  "zip_code": "11201"
}

The API will return an ordered list of Providers who match the query along with their names, addresses, and other demographic data. The id field returned refers to the Provider's NPI number. This is the key that is used to identify the Provider across different API endpoints.

Finding Networks

A Network is a collection of Providers that are under a particular contract with a given Carrier. A given Carrier will often have multiple Networks. For example, there may be a large national Network as well as several smaller regional Networks.

The API supports searching for Networks by Carrier, market and state. For more details view the endpoint documentation

Matching Providers to Networks

In order to determine if a Provider is covered by a user’s Plan, you will need to map the Provider to a Network. There are several methods to do this using the API

You can specify one or more npi values in the plan search. To do so, include a list of providers in the request

POST /plans/medical/search
{
  ...
  "providers": [
    { "npi": 1234567890 },
    { "npi": 2345678901 }
  ]
  ...
}

The response will then return a list of `in_network_ids` and `out_of_network_ids` for each `Plan`

{ “plans”: [ … { … “id”: “12345NY1234567”, “in_network_ids”: [1234567890], “out_of_network_ids”: [1234567890] … }, { … “id”: “12345NY2345678”, “in_network_ids”: [1234567890, 1234567890], “out_of_network_ids”: [] … } … ] }

Simply reference the Provider in question by its id for each Plan to see if that Provider is in-network for the Plan.

Matching by Plan ID

Given a Provider's id, you can retrieve all of his or her hios_ids

For more details see the endpoint documentation

GET /providers/1234567890
{
  "provider": {
    ...
    "hios_ids": [
      ...
      "12345NY1234567"
      ...
    ]
    ...
  }
}

The returned hios_ids can be used to cross-reference a Plan

Matching by Network

Once you have an ID returned from the Network search endpoint, you can cross-reference it with the network_ids returned from both the Provider search and Provider details endpoints.

This is useful for large group data or when you are not dealing with Plans directly, but rather at the Network level.

Quoting

Quoting

POST /groups
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "group": {
    "chamber_association": true,
    "company_name": "Foo Bar, Inc.",
    "contact_email": "john@foobar.inc",
    "contact_name": "John Doe",
    "contact_phone": "212-555-1234",
    "external_id": "abc123",
    "sic_code": "0700"
  },
  "locations": [
    {
      "external_id": "def123",
      "fips_code": "36081",
      "name": "Headquarters",
      "number_of_employees": 32,
      "primary": true,
      "zip_code": "11423"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "group": {
      "type": "object",
      "properties": {
        "chamber_association": {
          "type": "boolean"
        },
        "company_name": {
          "type": "string"
        },
        "contact_email": {
          "type": "string"
        },
        "contact_name": {
          "type": "string"
        },
        "contact_phone": {
          "type": "string"
        },
        "external_id": {
          "type": "string"
        },
        "sic_code": {
          "type": "string"
        }
      },
      "description": "Group Attributes"
    },
    "locations": {
      "type": "array",
      "description": "List of Locations"
    }
  }
}
Responses201
Headers
Content-Type: application/json
Body
{
  "group": {
    "chamber_association": true,
    "company_name": "Foo Bar, Inc.",
    "contact_email": "john@foobar.inc",
    "contact_name": "John Doe",
    "contact_phone": "212-555-1234",
    "external_id": "abc123",
    "id": "b215b6bcdb",
    "sic_code": "0700"
  },
  "locations": [
    {
      "external_id": "def123",
      "fips_code": "36081",
      "id": "8be378c035",
      "name": "Headquarters",
      "number_of_employees": 32,
      "primary": true,
      "zip_code": "11423"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "group": {
      "type": "object",
      "properties": {
        "chamber_association": {
          "type": "boolean"
        },
        "company_name": {
          "type": "string"
        },
        "contact_email": {
          "type": "string"
        },
        "contact_name": {
          "type": "string"
        },
        "contact_phone": {
          "type": "string"
        },
        "external_id": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "sic_code": {
          "type": "string"
        }
      },
      "description": "Group Attributes"
    },
    "locations": {
      "type": "array",
      "description": "List of Locations"
    }
  }
}

Create a Group
POST/groups

Use this endpoint to create a new Group. See the Overview Section for more information.

Parameters

Group (required)

The group key is a required object that contains information related to the group that will be quoted.

Field Type Notes
chamber_association
(required)
boolean
company_name
(required)
string
contact_email
(optional)
string
contact_name
(optional)
string
contact_phone
(optional)
string The format is 123-123-1234.
external_id
(required)
string A field you can use to identify the group with. This can be an empty string.
sic_code
(required)
string

Locations (required)

The locations key is a requied list of objects, each detailing a location in which the group has an office. There should only be one primary location. The primary location is used to determine the plan availability for that group during the quoting process.

Field Type Notes
external_id
(optional)
string A field you can use to identify the location with. This can be an empty string.
fips_code
(required)
string
name
(required)
string
number_of_employees
(required)
integer
primary
(required)
boolean
zip_code
(required)
string

Quoting

GET /groups/b215b6bcdb
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "group": {
    "chamber_association": true,
    "company_name": "Foo Bar, Inc.",
    "contact_email": "john@foobar.inc",
    "contact_name": "John Doe",
    "contact_phone": "212-555-1234",
    "external_id": "abc123",
    "id": "b215b6bcdb",
    "sic_code": "0700"
  },
  "locations": [
    {
      "external_id": "def123",
      "fips_code": "36081",
      "id": "8be378c035",
      "name": "Headquarters",
      "number_of_employees": 32,
      "primary": true,
      "zip_code": "11423"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "group": {
      "type": "object",
      "properties": {
        "chamber_association": {
          "type": "boolean"
        },
        "company_name": {
          "type": "string"
        },
        "contact_email": {
          "type": "string"
        },
        "contact_name": {
          "type": "string"
        },
        "contact_phone": {
          "type": "string"
        },
        "external_id": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "sic_code": {
          "type": "string"
        }
      },
      "description": "Group Attributes"
    },
    "locations": {
      "type": "array",
      "description": "List of Locations"
    }
  }
}

Display a Group
GET/groups/{id}

Retrieve the details for a Group

URI Parameters
HideShow
id
string (required) Example: b215b6bcdb

ID of the Group


Quoting

PUT /groups/b215b6bcdb/members
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "members": [
    {
      "cobra": true,
      "date_of_birth": "1980-10-31",
      "dependents": [
        {
          "date_of_birth": "2005-10-21",
          "gender": "F",
          "last_used_tobacco": "2017-12-10",
          "relationship": "child",
          "same_household": true
        }
      ],
      "external_id": "def123",
      "fips_code": "36081",
      "gender": "F",
      "last_used_tobacco": "2017-10-30",
      "location_id": "8be378c035",
      "retiree": false,
      "zip_code": "11423"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "members": {
      "type": "array",
      "description": "List of Members"
    }
  }
}
Responses200
Headers
Content-Type: application/json
Body
{
  "members": [
    {
      "cobra": true,
      "date_of_birth": "1980-10-31",
      "dependents": [
        {
          "date_of_birth": "2005-10-21",
          "gender": "F",
          "last_used_tobacco": "2017-12-10",
          "relationship": "child",
          "same_household": true
        }
      ],
      "external_id": "def123",
      "fips_code": "36081",
      "gender": "F",
      "id": "eec232e7d9",
      "last_used_tobacco": "2017-10-30",
      "location_id": "8be378c035",
      "retiree": false,
      "zip_code": "11423"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "members": {
      "type": "array",
      "description": "List of Members"
    }
  }
}

Create or Update Members
PUT/groups/{id}/members

Add Members and their Dependents to a Group. If called on the same group twice, it will fully replace the members for that group. See the Overview Section for more information.

Parameters

Members (required)

The members key is a required list containing the Members for the Group and their Dependents.

Field Type Notes
cobra
(required)
boolean
date_of_birth
(required)
string The format is YYYY-MM-DD. Members cannot be less than 0 years old at the time of quoting.
dependents
(required)
list If the member does not have dependents, please pass an empty list.
external_id
(required)
string A field you can use to identify the member with. This can be an empty string.
fips_code
(required)
string
gender
(required)
string The options are: M or F.
last_used_tobacco
(required)
string The format is YYYY-MM-DD. For those that have never smoked, please pass null.
location_id
(required)
string The location where the member works. The identifier comes from the response when creating a Group.
retiree
(required)
boolean
zip_code
(required)
string
Dependents

The dependents key is a required list containing each Dependent the Member has. If the Member has no dependents, an empty list should be passed.

Field Type Notes
date_of_birth
(required)
string The format is YYYY-MM-DD. Dependents cannot be less than 0 years old at the time of quoting.
gender
(required)
string The options are M or F.
last_used_tobacco
(required)
string The format is YYYY-MM-DD. For those that have never smoked, please pass null.
relationship
(required)
string Please see the Overview Section for a list of allowed relationships.
same_household
(required)
boolean Does the dependent live in the same household as the member?
URI Parameters
HideShow
id
string (required) Example: b215b6bcdb

ID of the Group


Quoting

POST /groups/b215b6bcdb/quotes
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "quote": {
    "carrier_ids": [
      "12345"
    ],
    "contribution_percentage": 90,
    "effective_date": "2018-12-01",
    "npn": "123456789",
    "participation_percentage": 75,
    "product_line": "medical",
    "rating_method": "age_banded",
    "voluntary": true
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "quote": {
      "type": "object",
      "properties": {
        "carrier_ids": {
          "type": "array"
        },
        "contribution_percentage": {
          "type": "number"
        },
        "effective_date": {
          "type": "string"
        },
        "npn": {
          "type": "string"
        },
        "participation_percentage": {
          "type": "number"
        },
        "product_line": {
          "type": "string"
        },
        "rating_method": {
          "type": "string"
        },
        "voluntary": {
          "type": "boolean"
        }
      },
      "description": "Quote Attributes"
    }
  }
}
Responses201
Headers
Content-Type: application/json
Body
{
  "quote": {
    "carrier_ids": [
      "12345"
    ],
    "contribution_percentage": 90,
    "created_at": "2018-10-23T12:00:00.000Z",
    "effective_date": "2018-12-01",
    "id": "5db8ce543d",
    "npn": "123456789",
    "participation_percentage": 75,
    "product_line": "medical",
    "rating_method": "age_banded",
    "voluntary": true
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "quote": {
      "type": "object",
      "properties": {
        "carrier_ids": {
          "type": "array"
        },
        "contribution_percentage": {
          "type": "number"
        },
        "created_at": {
          "type": "string"
        },
        "effective_date": {
          "type": "string"
        },
        "id": {
          "type": "string"
        },
        "npn": {
          "type": "string"
        },
        "participation_percentage": {
          "type": "number"
        },
        "product_line": {
          "type": "string"
        },
        "rating_method": {
          "type": "string"
        },
        "voluntary": {
          "type": "boolean"
        }
      },
      "description": "Quote Attributes"
    }
  }
}

Create a Quote
POST/groups/{id}/quotes

Generate a Quote for a Group. See the Overview Section for more information.

Parameters

Quote (required)

The quote key is required and it contains the criteria below for the quote that is being generated.

Field Type Notes
contribution_percentage
(required)
integer
effective_date
(required)
string The format is YYYY-MM-DD.
npn
(required)
string The National Producer Number
participation_percentage
(required)
integer
product_line
(required)
string The product line you wish to quote for. The options are medical, dental, or vision.
rating_method
(required)
string The options are age_banded, 4_tier_composite, 3_tier_composite, 2_tier_composite, and adult_child_tier_composite. If we do not have a method for a plan, we will use a method we have for that plan.
voluntary
(required)
boolean
carrier_ids
(optional)
list A list of issuer_ids in string format. Only provide this key if you want to limit the carriers quoted.
URI Parameters
HideShow
id
string (required) Example: b215b6bcdb

ID of the Group


Quoting

GET /quotes/5db8ce543d/rates
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "rates": [
    {
      "dependent_premium": "2500.00",
      "id": "bb1f3523f0",
      "member_premium": "7500.00",
      "plan_id": "12345CA1234567",
      "premiums": {
        "2_tier_composite": {
          "employee_only": "200.00",
          "employee_plus_family": "400.00",
          "total": "10000.00"
        },
        "3_tier_composite": {
          "employee_only": "200.00",
          "employee_plus_family": "300.00",
          "employee_plus_one": "250.00",
          "total": "10000.00"
        },
        "4_tier_composite": {
          "employee_only": "200.00",
          "employee_plus_children": "220.00",
          "employee_plus_family": "300.00",
          "employee_plus_spouse": "230.00",
          "total": "10000.00"
        },
        "adult_child_tier_composite": {
          "adult": "200.00",
          "child": "400.00",
          "total": "10000.00"
        },
        "age_banded": {
          "total": "10000.00",
          "total_dependent": "2500.00",
          "total_member": "7500.00"
        }
      },
      "source": "carrier",
      "total_premium": "10000.00"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "rates": {
      "type": "array",
      "description": "List of Rates"
    }
  }
}

Display Rates
GET/quotes/{id}/rates

Retrieve the rates for a Quote.

The source key shows the source from which we received the rates. The possible values are detailed below.

Source Value Notes
carrier The rates were received from a carrier.
state The rates originate from state filings.
cms The rates originate from Centers for Medicare & Medicaid Services (CMS) filings.
null Only Quotes generated before the release of this key (2019-09-10) will contain null source values.

The premiums key contains the available rating methods we have for the each plan. The rating methods are detailed below.

Premiums Key Notes
age_banded The keys include total_member, total_dependent, and total. The values are the sums.
4_tier_composite The keys include employee_only, employee_plus_spouse, employee_plus_children, employee_plus_family, and total. The values are the per-member rate for each bucket.
3_tier_composite The keys include employee_only, employee_plus_one, employee_plus_family, and total. The values are the per-member rate for each bucket.
2_tier_composite The keys include employee_only, employee_plus_family, and total. The values are the per-member rate for each bucket.
adult_child_tier_composite The keys include adult, child, and total. The values are the per-member rate for each bucket.

Notice: Please note that the premiums key is currently only available for medical Quotes. Please reach out to support@vericred.com for updates on its availability for dental and vision quotes.

URI Parameters
HideShow
id
string (required) Example: 5db8ce543d

ID of the quote


Quoting

GET /rates/bb1f3523f0/member_rates
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "member_rates": [
    {
      "dependent_premium": "125.00",
      "id": "eec232e7d9",
      "member_external_id": "abc234",
      "member_id": "eec232e7d9",
      "member_premium": "100.00",
      "premiums": {
        "2_tier_composite": {
          "category": "employee_only",
          "total": "230.00"
        },
        "3_tier_composite": {
          "category": "employee_only",
          "total": "230.00"
        },
        "4_tier_composite": {
          "category": "employee_only",
          "total": "230.00"
        },
        "adult_child_tier_composite": {
          "adult": "200.00",
          "child": "400.00",
          "total": "10000.00"
        },
        "age_banded": {
          "dependent": "125.00",
          "member": "100.00",
          "total": "225.00"
        }
      },
      "total_premium": "225.00"
    }
  ],
  "meta": {
    "total": 10
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "member_rates": {
      "type": "array",
      "description": "List of MemberRates"
    },
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    }
  }
}

Display Member Rates
GET/rates/{id}/member_rates

Retrieve the member-level rates for a particular Rate returned for a Quote.

The premiums key contains the available rating methods we have for the Rate, along with the member-specific rates for each method. For composite methods, the category the member falls into is shown.

URI Parameters
HideShow
id
string (required) Example: bb1f3523f0

ID of the Rate


Drugs

Drugs

GET /drugs?search_term=Zyrtec
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "drug_packages": [
    {
      "active_ingredient_strength": "10mg",
      "description": "Zyrtec 10 mg tablet",
      "id": "52959-0482-01",
      "non_proprietary_name": "Zyrtec",
      "proprietary_name": "Zyrtec"
    }
  ],
  "id": "a9f4a8f8ccbd42be",
  "med_id": 1,
  "name": "Zyrtec 10 mg tablet",
  "rx_cui_id": "1014678"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "drug_packages": {
      "type": "array",
      "description": "Drug packages"
    },
    "id": {
      "type": "string",
      "description": "Primary key"
    },
    "med_id": {
      "type": "number",
      "description": "Foreign key to Meds (can be nil)"
    },
    "name": {
      "type": "string",
      "description": "The name of the Drug"
    },
    "rx_cui_id": {
      "type": "string",
      "description": "Foreign key to Rx-Norm"
    }
  }
}

Drug Search
GET/drugs{?search_term}

Search for drugs by proprietary name.

New Verison: In order to use this endpoint, please set your version header to v7. We still support previous versions of this endpoint. For more information on how to set version headers, see Versioning of this document.

URI Parameters
HideShow
search_term
string (required) Example: Zyrtec

Full or partial proprietary name of drug


Drugs

GET /drugs/bb1f3523f0/coverages?year=2019&line_of_coverage=medical&state_code=CA&market=individual
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "coverages": [
    {
      "plan_id": "88582NY0230001",
      "prior_authorization": true,
      "quantity_limit": true,
      "step_therapy": true,
      "tier": "generic"
    }
  ],
  "meta": {
    "total": 10
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "coverages": {
      "type": "array",
      "description": "Drug coverage search results"
    },
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    }
  }
}

Drug Coverage Search
GET/drugs/{id}/coverages{?year,line_of_coverage,state_code,market}

Drug coverages are the specific tier level, quantity limit, prior authorization and step therapy for a given Drug/Plan combination. This endpoint returns all drug coverages for a given Drug.

Tiers

Possible values for tier:

Tier Description
generic Unbranded drugs, with the same active ingredients as their brand-name equivalents, and generally available at a lower cost.
preferred_brand Brand-name drugs included on the health plan’s formulary. Generally more expensive than generics, and less expensive than non-preferred drugs.
non_preferred_brand Brand-name drugs not included on the health plan’s formulary. These generally have a higher coinsurance.
specialty Used to treat complex conditions like cancer. May require special handling or monitoring. May be generic or brand-name. Generally the most expensive drugs covered by a plan.
not_covered Specifically excluded from the health plan.
not_listed Neither included nor excluded from the health plan. Most plans provide some default level of coverage for unlisted drugs.
URI Parameters
HideShow
id
string (required) Example: bb1f3523f0

ID of the Drug

year
string (required) Example: 2019

Plan Year

line_of_coverage
string (required) Example: medical

Line of coverage (medical or medicare_advantage)

state_code
string (required) Example: CA

Two-character state code

market
string (optional) Example: individual

Plan Market (individual or small_group)


Formularies

Formularies

GET /formularies?search_term=HIX PPO&rx_bin=123456&rx_group=HEALTH&rx_pcn=9999
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "formularies": [
    {
      "id": 123,
      "name": "Aetna 3 Tier"
    }
  ],
  "meta": {
    "total": 10
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "formularies": {
      "type": "array",
      "description": "List of formularies."
    },
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    }
  }
}

Formulary Search
GET/formularies{?search_term,rx_bin,rx_group,rx_pcn}

Search for drugs by proprietary name

URI Parameters
HideShow
search_term
string (optional) Example: HIX PPO

Full or partial name of the formulary

rx_bin
string (optional) Example: 123456

RX BIN Number (found on an insurance card)

rx_group
string (optional) Example: HEALTH

RX Group String (found on an insurance card)

rx_pcn
string (optional) Example: 9999

RX PCN Number (found on an insurance card)


Formularies

GET /formularies/123/drug_packages/01002-1200-11
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "coverage": {
    "plan_id": "88582NY0230001",
    "prior_authorization": true,
    "quantity_limit": true,
    "step_therapy": true,
    "tier": "generic"
  },
  "drug_package": {
    "description": "Claritin 24 hour 100 ct.",
    "id": "07777-3105-01",
    "med_id": 1,
    "rx_cui_id": "83629828"
  },
  "formulary": {
    "id": 123,
    "name": "Aetna 3 Tier"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "coverage": {
      "type": "object",
      "properties": {
        "plan_id": {
          "type": "string",
          "description": "Plan Identifier"
        },
        "prior_authorization": {
          "type": "boolean",
          "description": "Prior authorization required"
        },
        "quantity_limit": {
          "type": "boolean",
          "description": "Quantity limit exists"
        },
        "step_therapy": {
          "type": "boolean",
          "description": "Step Treatment required"
        },
        "tier": {
          "type": "string",
          "description": "Tier Name"
        }
      },
      "description": "DrugCoverage"
    },
    "drug_package": {
      "type": "object",
      "properties": {
        "description": {
          "type": "string",
          "description": "Package description"
        },
        "id": {
          "type": "string",
          "description": "National Drug Code ID (Package)"
        },
        "med_id": {
          "type": "number",
          "description": "Med ID"
        },
        "rx_cui_id": {
          "type": "string",
          "description": "Rx CUI ID"
        }
      },
      "description": "DrugPackage"
    },
    "formulary": {
      "type": "object",
      "properties": {
        "id": {
          "type": "number",
          "description": "Primary key"
        },
        "name": {
          "type": "string",
          "description": "Name of the Formulary"
        }
      },
      "description": "Formulary"
    }
  }
}

Formulary Drug Package Search
GET/formularies/{formulary_id}/drug_packages/{ndc_package_code}

Search for coverage by Formulary and DrugPackage ID

URI Parameters
HideShow
formulary_id
string (required) Example: 123

ID of the Formulary in question

ndc_package_code
string (required) Example: 01002-1200-11

ID of the DrugPackage in question


Networks

Networks

GET /networks?search_term=Enhanced PPO&line_of_coverage=medical&carrier_id=33333&market=individual&state_code=CA&effective_date=2019-01-01&page=1&per_page=10
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "networks": [
    {
      "carrier_ids": [
        "33333",
        "H2649"
      ],
      "carrier_name": "UHC",
      "id": 1,
      "lines_of_coverage": [
        "medical"
      ],
      "markets": [
        "individual",
        "small_group"
      ],
      "name": "Open Choice",
      "state_codes": [
        "CA",
        "NY"
      ]
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "networks": {
      "type": "array",
      "description": "Networks that fit the requested criterion."
    }
  }
}

Network Search
GET/networks{?search_term,line_of_coverage,carrier_id,market,state_code,effective_date,page,per_page}

The network search endpoint enables you to find networks by many parameters.

A network encompasses a list of the doctors, other health care providers, and hospitals that a plan has contracted with to provide medical care to its Members. This endpoint is paginated.

New Verison: In order to use this endpoint, please set your version header to v7. If you do not set the version header, you will be limited to the following parameters: carrier_id, market, state, and effective_date and you will see limited information in the response. For more information on how to set version headers, see Versioning of this document.

URI Parameters
HideShow
search_term
string (optional) Example: Enhanced PPO

Full or partial name of the network

line_of_coverage
string (optional) Example: medical

The line of coverage of the network. Possible values are medical, medicare_advantage, dental

carrier_id
string (optional) Example: 33333

Carrier HIOS Issuer ID (e.g. 10544) or Medicare Contract Issuer ID (e.g. H2649)

market
string (optional) Example: individual

Type of Plan to which this network is attached. Possible values are individual, small_group, large_group

state_code
string (optional) Example: CA

A state code (e.g. CA) in which the network is available

effective_date
string (optional) Example: 2019-01-01

Use this to specify a date on which the network must be or have been active

page
number (optional) Example: 1

Page of paginated response

per_page
number (optional) Example: 10

Responses per page


Networks

GET /networks/100001
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "network": {
    "carrier_ids": [
      "33333",
      "H2649"
    ],
    "carrier_name": "UHC",
    "id": 1,
    "lines_of_coverage": [
      "medical"
    ],
    "markets": [
      "individual",
      "small_group"
    ],
    "name": "Open Choice",
    "state_codes": [
      "CA",
      "NY"
    ]
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "network": {
      "type": "object",
      "properties": {
        "carrier_ids": {
          "type": "array",
          "description": "List of Carrier External Identifiers"
        },
        "carrier_name": {
          "type": "string",
          "description": "Name of the Network Carrier"
        },
        "id": {
          "type": "number",
          "description": "Primary key"
        },
        "lines_of_coverage": {
          "type": "array",
          "description": "Lines of coverage"
        },
        "markets": {
          "type": "array",
          "description": "List of markets"
        },
        "name": {
          "type": "string",
          "description": "Name of the Network"
        },
        "state_codes": {
          "type": "array",
          "description": "List of state codes"
        }
      },
      "description": "Network details"
    }
  }
}

Display a Network
GET/networks/{id}

The network details endpoint enables you to get information about a network by providing its id.

A network encompasses a list of the doctors, other health care providers, and hospitals that a plan has contracted with to provide medical care to its Members.

URI Parameters
HideShow
id
number (required) Example: 100001

Primary key of the network


Networks

POST /networks/100001/network_comparisons
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "network_ids": [
    900001
  ],
  "radius": 100,
  "zip_code": "11423"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "network_ids": {
      "type": "array",
      "description": "List of Networks with which to compare the base Network"
    },
    "radius": {
      "type": "number",
      "description": "Radius from the provided Zip Code within which to search"
    },
    "zip_code": {
      "type": "string",
      "description": "Zip Code to use as a search origin"
    }
  },
  "required": [
    "network_ids",
    "radius",
    "zip_code"
  ]
}
Responses200
Headers
Content-Type: application/json
Body
{
  "network_comparisons": [
    {
      "accepting_insurance_count": 50,
      "base_network_id": 1,
      "base_network_unique_count": 100,
      "comparison_network_id": 2,
      "comparison_network_unique_count": 200,
      "network_overlap_count": 300
    }
  ],
  "networks": [
    {
      "carrier_name": "UHC",
      "id": 1,
      "name": "Open Choice"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "network_comparisons": {
      "type": "array",
      "description": "NetworkComparisons"
    },
    "networks": {
      "type": "array",
      "description": "Networks"
    }
  }
}

Compare Multiple Networks
POST/networks/{id}/network_comparisons

Compare provider counts in a given area between a base network and one or more comparison networks.

Comparing Networks

Comparison of provider counts within a radius requires that you provide a zip_code and radius to use as a search area. The response returns the total number of unique Providers in the Base Network (i.e. those who are not present in the Comparison Network), The number of unique Providers in the Comparison Network (i.e. those who are not present in the Base Network), and the count of Providers who are in both Networks

URI Parameters
HideShow
id
number (required) Example: 100001

Primary key of the base network


Networks

POST /networks/disruption_analysis?page=1&per_page=1
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "network_ids": [
    100356
  ],
  "npis": [
    123456789,
    234565673,
    981237923
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "network_ids": {
      "type": "array",
      "description": "List of Vericred Network identifiers"
    },
    "npis": {
      "type": "array",
      "description": "List of Provider NPIs"
    }
  }
}
Responses200
Headers
Content-Type: application/json
Body
{
  "disruption_analysis": [
    {
      "disruption_percentage": 33.33,
      "in_network_npis": [
        123456789,
        234565673
      ],
      "network_id": 100356,
      "out_of_network_npis": [
        981237923
      ]
    }
  ],
  "meta": {
    "total": 10
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "disruption_analysis": {
      "type": "array",
      "description": "Disruption Analysis for each requested Network"
    },
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    }
  }
}

Disruption Analysis
POST/networks/disruption_analysis{?page,per_page}

Calculate the percentage of provider NPIs that are out-of-network for a set of networks. If you are interested in using this endpoint, please contact support@vericred.com for more details.

URI Parameters
HideShow
page
number (optional) Example: 1

Page of paginated response

per_page
number (optional) Example: 1

Responses per page


NetworkSizes

NetworkSizes

POST /network_sizes/search
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "network_ids": [
    1
  ],
  "state_ids": [
    "Hello, world!"
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "network_ids": {
      "type": "array",
      "description": "List of Network Ids"
    },
    "state_ids": {
      "type": "array",
      "description": "List of State Ids"
    }
  }
}
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "network_sizes": [
    {
      "count": 100,
      "network_id": 123,
      "state_id": "CA"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "network_sizes": {
      "type": "array",
      "description": "Network Sizes"
    }
  }
}

Network Sizes
POST/network_sizes/search

The number of in-network Providers for each network/state combination provided. This data is recalculated nightly.


NetworkSizes

GET /states/CA/network_sizes?page=1&per_page=1
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "network_sizes": [
    {
      "count": 100,
      "network_id": 123,
      "state_id": "CA"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "network_sizes": {
      "type": "array",
      "description": "Network Sizes"
    }
  }
}

State Network Sizes
GET/states/{state_id}/network_sizes{?page,per_page}

The number of in-network Providers for each network in a given state. This data is recalculated nightly. The endpoint is paginated.

URI Parameters
HideShow
state_id
string (required) Example: CA

State code

page
number (optional) Example: 1

Page of paginated response

per_page
number (optional) Example: 1

Responses per page


Major Medical Plans

Major Medical Plans

GET /plans/medical/88582NY0230001?year=2020
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "plan": {
    "abortion_rider": false,
    "actuarial_value": 80,
    "adult_dental": true,
    "age29_rider": false,
    "ambulance": "In-Network: 25% after deductible / Out-of-Network: 25% after deductible",
    "benefits_summary_url": "http://www.emblemhealth.com/~/media/Files/PDF/HIXHub/BenefitSummary_SelectCareSilver.pdf",
    "buy_link": "http://www.healthbenefitexchange.ny.gov/",
    "carrier_disclaimers": "Plan only available for companies with more than 30 employees.",
    "carrier_name": "EmblemHealth",
    "child_dental": "In-Network: $0 / Out-of-Network: 100%",
    "child_eye_exam": "In-Network: $0 / Out-of-Network: 100%",
    "child_eyewear": "In-Network: $0 / Out-of-Network: 100%",
    "chiropractic_services": false,
    "coinsurance": 20,
    "customer_service_phone_number": "1-866-640-3889",
    "diagnostic_test": "In-Network: 25% after deductible / Out-of-Network: 100%",
    "display_name": "Aetna PPO 20/5000",
    "dp_rider": true,
    "drug_formulary_url": "http://www.emblemhealth.com/~/media/Files/PDF/Pharmacy/ValuePlus_Formulary.pdf",
    "durable_medical_equipment": "In-Network: 25% after deductible / Out-of-Network: 100%",
    "effective_date": "2017-01-01",
    "embedded_deductible": "non_embedded",
    "emergency_room": "Deductible, then $150",
    "essential_health_benefits_percentage": 1,
    "expiration_date": "2017-12-31",
    "family_drug_deductible": "Included in Medical",
    "family_drug_moop": "Included in Medical",
    "family_medical_deductible": "$4,000",
    "family_medical_moop": "$11,000",
    "fp_rider": true,
    "gated": false,
    "generic_drugs": "$10",
    "habilitation_services": "In-Network: $0 / Out-of-Network: 100%",
    "hios_issuer_id": "1",
    "home_health_care": "In-Network: $0 / Out-of-Network: 100%",
    "hospice_service": "In-Network: $0 / Out-of-Network: 100%",
    "hsa_eligible": false,
    "id": "88582NY0230001",
    "identifiers": [
      {
        "type": "contract_code",
        "value": "Identifier 1"
      }
    ],
    "imaging": "In-Network: 25% after deductible / Out-of-Network: 100%",
    "imaging_center": "In-Network: 25% after deductible / Out-of-Network: 100%",
    "imaging_physician": "In-Network: 25% after deductible / Out-of-Network: 100%",
    "individual_drug_deductible": "Included in Medical",
    "individual_drug_moop": "Included in Medical",
    "individual_medical_deductible": "$2,000",
    "individual_medical_moop": "$5,500",
    "infertility_treatment_rider": false,
    "inpatient_birth": "In-Network: $0 / Out-of-Network: 100%",
    "inpatient_birth_physician": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
    "inpatient_facility": "Deductible, then $1,500 per admission\"",
    "inpatient_mental_health": "In-Network: $0 / Out-of-Network: 100%",
    "inpatient_physician": "Included in inpatient facility",
    "inpatient_substance": "In-Network: $0 / Out-of-Network: 100%",
    "lab_test": "In-Network: 25% after deductible / Out-of-Network: 100%",
    "level": "silver",
    "logo_url": "https://d1hm12jr612u3r.cloudfront.net/images/carriers/174/1438891372/thumb.png?1438891372",
    "mail_order_rx": 1.5,
    "name": "Select Care Silver, Age 29 Rider",
    "network_ids": [
      1,
      3
    ],
    "network_size": 5000,
    "networks": [
      {
        "id": 1,
        "name": "Open Choice"
      }
    ],
    "non_preferred_brand_drugs": "$70",
    "nonpreferred_generic_drug_share": "$70",
    "nonpreferred_specialty_drug_share": "$70",
    "off_market": false,
    "on_market": true,
    "out_of_network_coverage": false,
    "outpatient_ambulatory_care_center": "In-Network: 25% after deductible / Out-of-Network: 100%",
    "outpatient_facility": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
    "outpatient_mental_health": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
    "outpatient_physician": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
    "outpatient_substance": "In-Network: $0 / Out-of-Network: 100%",
    "plan_ancestors": [
      {
        "id": "Identifier 1",
        "year": 2019
      }
    ],
    "plan_calendar": "calendar_year",
    "plan_coinsurance": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
    "plan_market": "shop",
    "plan_type": "HMO",
    "postnatal_care": "In-Network: $0 / Out-of-Network: 100%",
    "preferred_brand_drugs": "$35",
    "prenatal_care": "In-Network: $0 / Out-of-Network: 100%",
    "prenatal_postnatal_care": "In-Network: $0 / Out-of-Network: 100%",
    "preventative_care": "In-Network: $0 / Out-of-Network: 100%",
    "primary_care_physician": "Deductible, then $30",
    "rehabilitation_services": "In-Network: $0 / Out-of-Network: 100%",
    "service_area_id": "11234-2016-WI01",
    "skilled_nursing": "In-Network: $0 / Out-of-Network: 100%",
    "skilled_nursing_facility_365": "unlimited",
    "source": "carrier",
    "specialist": "Deductible, then $50",
    "specialty_drugs": "$70",
    "telemedicine": false,
    "type": "ACAPlan2018",
    "updated_at": "2016-01-01",
    "urgent_care": "In-Network: $0 / Out-of-Network: 100%"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "plan": {
      "type": "object",
      "properties": {
        "abortion_rider": {
          "type": "boolean",
          "description": "True if plan covers abortion when there is no public funding available"
        },
        "actuarial_value": {
          "type": "number",
          "description": "Percentage of total average costs for covered benefits that a plan will cover."
        },
        "adult_dental": {
          "type": "boolean",
          "description": "Does the plan provide dental coverage for adults?"
        },
        "age29_rider": {
          "type": "boolean",
          "description": "True if the plan allows dependents up to age 29"
        },
        "ambulance": {
          "type": "string",
          "description": "Benefits string for ambulance coverage"
        },
        "benefits_summary_url": {
          "type": "string",
          "description": "Link to the summary of benefits and coverage (SBC) document."
        },
        "buy_link": {
          "type": "string",
          "description": "Link to a location to purchase the plan."
        },
        "carrier_disclaimers": {
          "type": "string",
          "description": "Most recent Disclaimer issued for this Plan"
        },
        "carrier_name": {
          "type": "string",
          "description": "Name of the insurance carrier"
        },
        "child_dental": {
          "type": "string",
          "description": "Child dental benefits summary"
        },
        "child_eye_exam": {
          "type": "string",
          "description": "Child eye exam benefits summary"
        },
        "child_eyewear": {
          "type": "string",
          "description": "Child eyewear benefits summary"
        },
        "chiropractic_services": {
          "type": "boolean",
          "description": "Does the plan provide a degree of coverage for chiropractic services?"
        },
        "coinsurance": {
          "type": "number",
          "description": "Standard cost share for most benefits"
        },
        "customer_service_phone_number": {
          "type": "string",
          "description": "Phone number to contact the insurance carrier"
        },
        "diagnostic_test": {
          "type": "string",
          "description": "Diagnostic tests benefit summary"
        },
        "display_name": {
          "type": "string",
          "description": "Alternate name for the Plan"
        },
        "dp_rider": {
          "type": "boolean",
          "description": "True if plan does not cover domestic partners"
        },
        "drug_formulary_url": {
          "type": "string",
          "description": "Link to the summary of drug benefits for the plan"
        },
        "durable_medical_equipment": {
          "type": "string",
          "description": "Benefits summary for durable medical equipment"
        },
        "effective_date": {
          "type": "string",
          "description": "Effective date of coverage."
        },
        "embedded_deductible": {
          "type": "string",
          "description": "Is the individual deductible for each covered person, embedded in the family deductible"
        },
        "emergency_room": {
          "type": "string",
          "description": "Description of costs when visiting the ER"
        },
        "essential_health_benefits_percentage": {
          "type": "number",
          "description": "Percentage of essential plan benefits"
        },
        "expiration_date": {
          "type": "string",
          "description": "Expiration date of coverage."
        },
        "family_drug_deductible": {
          "type": "string",
          "description": "Deductible for drugs when a family is on the plan."
        },
        "family_drug_moop": {
          "type": "string",
          "description": "Maximum out-of-pocket for drugs when a family is on the plan"
        },
        "family_medical_deductible": {
          "type": "string",
          "description": "Deductible when a family is on the plan"
        },
        "family_medical_moop": {
          "type": "string",
          "description": "Maximum out-of-pocket when a family is on the plan"
        },
        "fp_rider": {
          "type": "boolean",
          "description": "True if plan does not cover family planning"
        },
        "gated": {
          "type": "boolean",
          "description": "Does the plan's network require a physician referral?"
        },
        "generic_drugs": {
          "type": "string",
          "description": "Cost for generic drugs"
        },
        "habilitation_services": {
          "type": "string",
          "description": "Habilitation services benefits summary"
        },
        "hios_issuer_id": {
          "type": "string"
        },
        "home_health_care": {
          "type": "string",
          "description": "Home health care benefits summary"
        },
        "hospice_service": {
          "type": "string",
          "description": "Hospice service benefits summary"
        },
        "hsa_eligible": {
          "type": "boolean",
          "description": "Is the plan HSA eligible?"
        },
        "id": {
          "type": "string",
          "description": "Government-issued HIOS plan ID"
        },
        "identifiers": {
          "type": "array",
          "description": "List of identifiers of this Plan"
        },
        "imaging": {
          "type": "string",
          "description": "Benefits summary for imaging coverage"
        },
        "imaging_center": {
          "type": "string",
          "description": "Imaging center benefits summary"
        },
        "imaging_physician": {
          "type": "string",
          "description": "Imaging physician benefits summary"
        },
        "individual_drug_deductible": {
          "type": "string",
          "description": "Deductible for drugs when an individual is on the plan"
        },
        "individual_drug_moop": {
          "type": "string",
          "description": "Maximum out-of-pocket for drugs when an individual is on the plan"
        },
        "individual_medical_deductible": {
          "type": "string",
          "description": "Deductible when an individual is on the plan"
        },
        "individual_medical_moop": {
          "type": "string",
          "description": "Maximum out-of-pocket when an individual is on the plan"
        },
        "infertility_treatment_rider": {
          "type": "boolean",
          "description": "True if plan covers infertility treatment"
        },
        "inpatient_birth": {
          "type": "string",
          "description": "Inpatient birth benefits summary"
        },
        "inpatient_birth_physician": {
          "type": "string",
          "description": "Description of the benefit for inpatient birth physician - this is called “Childbirth/delivery professional services” on an SBC"
        },
        "inpatient_facility": {
          "type": "string",
          "description": "Cost under the plan for an inpatient facility"
        },
        "inpatient_mental_health": {
          "type": "string",
          "description": "Inpatient mental helath benefits summary"
        },
        "inpatient_physician": {
          "type": "string",
          "description": "Cost under the plan for an inpatient physician"
        },
        "inpatient_substance": {
          "type": "string",
          "description": "Inpatient substance abuse benefits summary"
        },
        "lab_test": {
          "type": "string",
          "description": "Lab test benefits summary"
        },
        "level": {
          "type": "string",
          "description": "Plan metal grouping (e.g. platinum, gold, silver, etc)"
        },
        "logo_url": {
          "type": "string",
          "description": "Link to a copy of the insurance carrier's logo"
        },
        "mail_order_rx": {
          "type": "number",
          "description": "Multiple of the standard Rx cost share for orders filled via mail order"
        },
        "name": {
          "type": "string",
          "description": "Marketing name of the plan"
        },
        "network_ids": {
          "type": "array",
          "description": "List of Vericred-generated network_ids"
        },
        "network_size": {
          "type": "number",
          "description": "Total number of Providers in network"
        },
        "networks": {
          "type": "array",
          "description": "List of networks associated with the plan"
        },
        "non_preferred_brand_drugs": {
          "type": "string",
          "description": "Cost under the plan for non-preferred brand drugs"
        },
        "nonpreferred_generic_drug_share": {
          "type": "string",
          "description": "Non-preferred generic drugs benefits summary"
        },
        "nonpreferred_specialty_drug_share": {
          "type": "string",
          "description": "Non-preferred specialty drugs benefits summary"
        },
        "off_market": {
          "type": "boolean",
          "description": "Is the plan off-market?"
        },
        "on_market": {
          "type": "boolean",
          "description": "Is the plan on-market?"
        },
        "out_of_network_coverage": {
          "type": "boolean",
          "description": "Does this plan provide any out of network coverage?"
        },
        "outpatient_ambulatory_care_center": {
          "type": "string",
          "description": "Outpatient ambulatory care center benefits summary"
        },
        "outpatient_facility": {
          "type": "string",
          "description": "Benefits summary for outpatient facility coverage"
        },
        "outpatient_mental_health": {
          "type": "string",
          "description": "Benefits summary for outpatient mental health coverage"
        },
        "outpatient_physician": {
          "type": "string",
          "description": "Benefits summary for outpatient physician coverage"
        },
        "outpatient_substance": {
          "type": "string",
          "description": "Outpatient substance abuse benefits summary"
        },
        "plan_ancestors": {
          "type": "array",
          "description": "A list of plan identifiers and years indicating the previous plans that the plan replaces"
        },
        "plan_calendar": {
          "type": "string",
          "description": "Are deductibles and MOOPs reset on Dec-31 (\"calendar year\"), 365 day(s) after enrollment date (\"plan year\"), or are both options available (\"both\")?"
        },
        "plan_coinsurance": {
          "type": "string",
          "description": "The plan-level standard cost-share for substantially all benefits. It includes in-network, out-of-network, and tiers if applicable"
        },
        "plan_market": {
          "type": "string",
          "description": "Market in which the plan is offered (on_marketplace, shop, etc)"
        },
        "plan_type": {
          "type": "string",
          "description": "Category of the plan (e.g. EPO, HMO, PPO, POS, Indemnity, PACE, Medicare-Medicaid, HMO w/POS, Cost, FFS, MSA)"
        },
        "postnatal_care": {
          "type": "string",
          "description": "Post-natal care benefits summary"
        },
        "preferred_brand_drugs": {
          "type": "string",
          "description": "Cost under the plan for perferred brand drugs"
        },
        "prenatal_care": {
          "type": "string",
          "description": "Prenatal care benefits summary"
        },
        "prenatal_postnatal_care": {
          "type": "string",
          "description": "Inpatient substance abuse benefits summary"
        },
        "preventative_care": {
          "type": "string",
          "description": "Benefits summary for preventative care"
        },
        "primary_care_physician": {
          "type": "string",
          "description": "Cost under the plan to visit a Primary Care Physician"
        },
        "rehabilitation_services": {
          "type": "string",
          "description": "Benefits summary for rehabilitation services"
        },
        "service_area_id": {
          "type": "string",
          "description": "Foreign key for service area"
        },
        "skilled_nursing": {
          "type": "string",
          "description": "Benefits summary for skilled nursing services"
        },
        "skilled_nursing_facility_365": {
          "type": "string",
          "description": "Does the plan cover full-time, year-round, nursing facilities?"
        },
        "source": {
          "type": "string",
          "description": "Source of the plan benefit data"
        },
        "specialist": {
          "type": "string",
          "description": "Cost under the plan to visit a specialist"
        },
        "specialty_drugs": {
          "type": "string",
          "description": "Cost under the plan for specialty drugs"
        },
        "telemedicine": {
          "type": "boolean",
          "description": "Indicates whether there is coverage for the remote delivery of medical benefits"
        },
        "type": {
          "type": "string",
          "description": "The type of the Plan"
        },
        "updated_at": {
          "type": "string",
          "description": "Time when plan was last updated"
        },
        "urgent_care": {
          "type": "string",
          "description": "Benefits summary for urgent care"
        }
      },
      "description": "Plan response"
    }
  }
}

Show Plan
GET/plans/medical/{id}{?year}

Retrieving Benefits for a Medical Plan

Show the details of an individual Plan. This includes all benefits for the Plan.

For more details on displaying Plans and their related data, see the Quoting section.

Notice: Please note that there are potential breaking changes in the 2020 plan schema. For backwards compatibility, the previous schema will be maintained for plans before the 2020 plan year until January 2, 2020. For more information, please see our 2020 ACA Medical Plan Data Update.

URI Parameters
HideShow
id
string (required) Example: 88582NY0230001

ID of the Plan

year
number (optional) Example: 2020

Plan year (defaults to current year)


Major Medical Plans

POST /plans/medical/search
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "applicants": [
    {
      "age": 21,
      "child": false,
      "smoker": false
    }
  ],
  "drug_packages": [
    {
      "id": "01002-1200-11",
      "med_id": 1
    }
  ],
  "enrollment_date": "2020-01-01",
  "fips_code": "36081",
  "household_income": 55000,
  "household_size": 1,
  "ids": [
    1
  ],
  "issuer_qualifications_met": [
    "12345"
  ],
  "market": "individual",
  "page": 1,
  "per_page": 20,
  "providers": [
    {
      "npi": 1234567890
    }
  ],
  "sort": "premium:asc",
  "zip_code": "11423"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "applicants": {
      "type": "array",
      "description": "Applicants for desired plans."
    },
    "drug_packages": {
      "type": "array",
      "description": "National Drug Code Package Id"
    },
    "enrollment_date": {
      "type": "string",
      "description": "Date of enrollment"
    },
    "fips_code": {
      "type": "string",
      "description": "County code to determine eligibility"
    },
    "household_income": {
      "type": "number",
      "description": "Total household income."
    },
    "household_size": {
      "type": "number",
      "description": "Number of people living in household."
    },
    "ids": {
      "type": "array",
      "description": "List of plan IDs to filter by"
    },
    "issuer_qualifications_met": {
      "type": "array",
      "description": "A list of HIOS Issuer IDs with specific plan eligibility qualifications"
    },
    "market": {
      "type": "string",
      "description": "Type of plan to search for."
    },
    "page": {
      "type": "number",
      "description": "Selected page of paginated response."
    },
    "per_page": {
      "type": "number",
      "description": "Results per page of response."
    },
    "providers": {
      "type": "array",
      "description": "List of providers to search for."
    },
    "sort": {
      "type": "string",
      "description": "Sort responses by plan field."
    },
    "zip_code": {
      "type": "string",
      "description": "5-digit zip code - this helps determine pricing."
    }
  }
}
Responses200
Headers
Content-Type: application/json
Body
{
  "coverages": [
    {
      "plan_id": "88582NY0230001",
      "prior_authorization": true,
      "quantity_limit": true,
      "step_therapy": true,
      "tier": "generic"
    }
  ],
  "meta": {
    "total": 10
  },
  "plans": [
    {
      "abortion_rider": false,
      "actuarial_value": 80,
      "adult_dental": true,
      "age29_rider": false,
      "ambulance": "In-Network: 25% after deductible / Out-of-Network: 25% after deductible",
      "benefits_summary_url": "http://www.emblemhealth.com/~/media/Files/PDF/HIXHub/BenefitSummary_SelectCareSilver.pdf",
      "buy_link": "http://www.healthbenefitexchange.ny.gov/",
      "carrier_disclaimers": "Plan only available for companies with more than 30 employees.",
      "carrier_name": "EmblemHealth",
      "child_dental": "In-Network: $0 / Out-of-Network: 100%",
      "child_eye_exam": "In-Network: $0 / Out-of-Network: 100%",
      "child_eyewear": "In-Network: $0 / Out-of-Network: 100%",
      "chiropractic_services": false,
      "coinsurance": 20,
      "customer_service_phone_number": "1-866-640-3889",
      "diagnostic_test": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "display_name": "Aetna PPO 20/5000",
      "dp_rider": true,
      "drug_formulary_url": "http://www.emblemhealth.com/~/media/Files/PDF/Pharmacy/ValuePlus_Formulary.pdf",
      "durable_medical_equipment": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "effective_date": "2017-01-01",
      "embedded_deductible": "non_embedded",
      "emergency_room": "Deductible, then $150",
      "essential_health_benefits_percentage": 1,
      "expiration_date": "2017-12-31",
      "family_drug_deductible": "Included in Medical",
      "family_drug_moop": "Included in Medical",
      "family_medical_deductible": "$4,000",
      "family_medical_moop": "$11,000",
      "fp_rider": true,
      "gated": false,
      "generic_drugs": "$10",
      "habilitation_services": "In-Network: $0 / Out-of-Network: 100%",
      "hios_issuer_id": "1",
      "home_health_care": "In-Network: $0 / Out-of-Network: 100%",
      "hospice_service": "In-Network: $0 / Out-of-Network: 100%",
      "hsa_eligible": false,
      "id": "88582NY0230001",
      "identifiers": [
        {
          "type": "contract_code",
          "value": "Identifier 1"
        }
      ],
      "imaging": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "imaging_center": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "imaging_physician": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "in_network_ids": [
        123456789,
        234567890
      ],
      "individual_drug_deductible": "Included in Medical",
      "individual_drug_moop": "Included in Medical",
      "individual_medical_deductible": "$2,000",
      "individual_medical_moop": "$5,500",
      "infertility_treatment_rider": false,
      "inpatient_birth": "In-Network: $0 / Out-of-Network: 100%",
      "inpatient_birth_physician": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "inpatient_facility": "Deductible, then $1,500 per admission\"",
      "inpatient_mental_health": "In-Network: $0 / Out-of-Network: 100%",
      "inpatient_physician": "Included in inpatient facility",
      "inpatient_substance": "In-Network: $0 / Out-of-Network: 100%",
      "lab_test": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "level": "silver",
      "logo_url": "https://d1hm12jr612u3r.cloudfront.net/images/carriers/174/1438891372/thumb.png?1438891372",
      "mail_order_rx": 1.5,
      "name": "Select Care Silver, Age 29 Rider",
      "network_ids": [
        1,
        3
      ],
      "network_size": 5000,
      "networks": [
        {
          "id": 1,
          "name": "Open Choice"
        }
      ],
      "non_preferred_brand_drugs": "$70",
      "nonpreferred_generic_drug_share": "$70",
      "nonpreferred_specialty_drug_share": "$70",
      "off_market": false,
      "on_market": true,
      "out_of_network_coverage": false,
      "out_of_network_ids": [
        123456789,
        234567890
      ],
      "outpatient_ambulatory_care_center": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "outpatient_facility": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "outpatient_mental_health": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "outpatient_physician": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "outpatient_substance": "In-Network: $0 / Out-of-Network: 100%",
      "plan_ancestors": [
        {
          "id": "Identifier 1",
          "year": 2019
        }
      ],
      "plan_calendar": "calendar_year",
      "plan_coinsurance": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "plan_market": "shop",
      "plan_type": "HMO",
      "postnatal_care": "In-Network: $0 / Out-of-Network: 100%",
      "preferred_brand_drugs": "$35",
      "premium": 533.24,
      "premium_source": "carrier",
      "premium_subsidized": 321.5,
      "prenatal_care": "In-Network: $0 / Out-of-Network: 100%",
      "prenatal_postnatal_care": "In-Network: $0 / Out-of-Network: 100%",
      "preventative_care": "In-Network: $0 / Out-of-Network: 100%",
      "primary_care_physician": "Deductible, then $30",
      "rehabilitation_services": "In-Network: $0 / Out-of-Network: 100%",
      "service_area_id": "11234-2016-WI01",
      "skilled_nursing": "In-Network: $0 / Out-of-Network: 100%",
      "skilled_nursing_facility_365": "unlimited",
      "source": "carrier",
      "specialist": "Deductible, then $50",
      "specialty_drugs": "$70",
      "telemedicine": false,
      "type": "ACAPlan",
      "updated_at": "2016-01-01",
      "urgent_care": "In-Network: $0 / Out-of-Network: 100%"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "coverages": {
      "type": "array",
      "description": "Coverages associated with the plan."
    },
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "plans": {
      "type": "array",
      "description": "Plan search results"
    }
  }
}

Search Plans
POST/plans/medical/search

Searching for Medical Plans

Determine the available Plans and their Premiums for a particular Family in a given Location.

For details on searching for Plans and their related data, see the Quoting Medical Plans section.

Notice: Please note that there are potential breaking changes in the 2020 plan schema. For backwards compatibility, the previous schema will be maintained for plans before the 2020 plan year until January 2, 2020. For more information, please see our 2020 ACA Medical Plan Data Update.

Parameters

Field Type Notes
zip_code
(required)
string
fips_code
(required)
string
market
(required)
string The options are: individual or small_group.
enrollment_date
(optional)
string The format is 2019-01-01. If this is not provided, we default it to today’s date.
applicants
(optional)
list Use this field to see premiums for individual quotes. See below for parameters.
drug_packages
(optional)
list Use this field to see drug coverage information by plan. Supply either the NDC Package Code or the Med ID of the Drug.
household_income
(optional)
int The total household income of the applicant for individual quotes.
household_size
(optional)
int The number of applicants and dependents applying for individual quotes.
ids
(optional)
list Use this field to hard filter results to certain HIOS IDs.
providers
(optional)
list Use this field to see if providers are in- or out-of-network for each plan by providing their NPIs.
issuer_qualifications_met
(optional)
list A list of HIOS Issuer IDs of which the end-user has answered qualification questions for.

Applicants (optional)

Field Type Notes
age
(required)
int
child
(required)
boolean
smoker
(required)
boolean

Additional Sorting

Plans can be sorted by the premium, carrier_name, level, and plan_type fields, by either ascending (as asc) or descending (as dsc) sort under the sort field.

Provider Data

The Major Medical Plans are paired with Network Provider Data

Drug coverages

Are included along with the rest of the plan data. See the description below for more details.

Issuer Qualifications

Some issuers require end users to answer questions before their plans can be made available to them, e.g. certain Association Health Plans. Vericred supports this by asking you to confirm that the end user has answered the requisite questions by passing the HIOS Issuer ID of the issuer in the optional issuer_qualifications_met request key. Plans for the requested issuer(s) that are available in the geographic area will have a -94 suffix in their id.

For information on the issuers with qualifications that are supported, please reach out to support@vericred.com.


Dental Plans

Dental Plans

GET /plans/dental/99eA4hhn?year=2018
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "dental_plan": {
    "audience": "individual",
    "benefits": {
      "bridges": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "crowns": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "denture_relines_rebases": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "denture_repair_and_adjustments": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "dentures": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "emergency_treatment": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "endodontics": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "family_annual_max": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "family_deductible": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "fluoride_treatment": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "implants": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "individual_annual_max": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "individual_deductible": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "inlays": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "onlays": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "oral_exam": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "oral_surgery": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "orthodontics_adult": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "orthodontics_child": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "periodontal_maintenance": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "periodontics": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "prophylaxis_cleaning": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "radiograph_bitewings": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "radiograph_other": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "restoration_fillings": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "sealant": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "simple_extraction": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "space_maintainers": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible"
    },
    "benefits_summary_url": "http://www.emblemhealth.com/~/media/Files/PDF/HIXHub/BenefitSummary_SelectCareSilver.pdf",
    "carrier_disclaimers": "Plan only available for companies with more than 30 employees.",
    "id": "uaLcmyru",
    "identifiers": [
      {
        "type": "issuer_internal_id",
        "value": "Identifier 1"
      }
    ],
    "issuer_name": "EmblemHealth",
    "logo_url": "https://d1hm12jr612u3r.cloudfront.net/images/carriers/174/1438891372/thumb.png?1438891372",
    "name": "Select Care Silver, Age 29 Rider",
    "network_size": 5000,
    "networks": [
      {
        "id": 1,
        "name": "Open Choice"
      }
    ],
    "plan_type": "HMO",
    "source": "carrier",
    "stand_alone": false
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "dental_plan": {
      "type": "object",
      "properties": {
        "audience": {
          "type": "string",
          "description": "The dental plan audience"
        },
        "benefits": {
          "type": "object",
          "properties": {
            "bridges": {
              "type": "string",
              "description": "Bridges benefit string"
            },
            "crowns": {
              "type": "string",
              "description": "Crowns benefit string"
            },
            "denture_relines_rebases": {
              "type": "string",
              "description": "Denture Relines/Rebases benefit string"
            },
            "denture_repair_and_adjustments": {
              "type": "string",
              "description": "Denture Repair and Adjustments benefit string"
            },
            "dentures": {
              "type": "string",
              "description": "Dentures benefit string"
            },
            "emergency_treatment": {
              "type": "string",
              "description": "Emergency Treatment benefit string"
            },
            "endodontics": {
              "type": "string",
              "description": "Endodontics benefit string"
            },
            "family_annual_max": {
              "type": "string",
              "description": "Family Annual Max benefit string"
            },
            "family_deductible": {
              "type": "string",
              "description": "Family Deductible benefit string"
            },
            "fluoride_treatment": {
              "type": "string",
              "description": "Fluoride Treatment benefit string"
            },
            "implants": {
              "type": "string",
              "description": "Implants benefit string"
            },
            "individual_annual_max": {
              "type": "string",
              "description": "Individual Annual Max benefit string"
            },
            "individual_deductible": {
              "type": "string",
              "description": "Individual Deductible benefit string"
            },
            "inlays": {
              "type": "string",
              "description": "Inlays benefit string"
            },
            "onlays": {
              "type": "string",
              "description": "Onlays benefit string"
            },
            "oral_exam": {
              "type": "string",
              "description": "Oral Exam benefit string"
            },
            "oral_surgery": {
              "type": "string",
              "description": "Oral Surgery benefit string"
            },
            "orthodontics_adult": {
              "type": "string",
              "description": "Orthodontics - Adult benefit string"
            },
            "orthodontics_child": {
              "type": "string",
              "description": "Orthodontics - Child benefit string"
            },
            "periodontal_maintenance": {
              "type": "string",
              "description": "Periodontal Maintenance benefit string"
            },
            "periodontics": {
              "type": "string",
              "description": "Periodontics benefit string"
            },
            "prophylaxis_cleaning": {
              "type": "string",
              "description": "Prophylaxis Cleaning benefit string"
            },
            "radiograph_bitewings": {
              "type": "string",
              "description": "Radiograph - Bitewings benefit string"
            },
            "radiograph_other": {
              "type": "string",
              "description": "Radiograph - Other benefit string"
            },
            "restoration_fillings": {
              "type": "string",
              "description": "Restoration - Fillings benefit string"
            },
            "sealant": {
              "type": "string",
              "description": "Sealant benefit string"
            },
            "simple_extraction": {
              "type": "string",
              "description": "Simple Extraction benefit string"
            },
            "space_maintainers": {
              "type": "string",
              "description": "Space Maintainers benefit string"
            }
          },
          "description": "Dental Plan Benefits"
        },
        "benefits_summary_url": {
          "type": "string",
          "description": "Link to the summary of benefits and coverage (SBC) document."
        },
        "carrier_disclaimers": {
          "type": "string",
          "description": "Most recent Disclaimer issued for this Plan"
        },
        "id": {
          "type": "string",
          "description": "The dental plan identifier"
        },
        "identifiers": {
          "type": "array",
          "description": "List of identifiers of this Plan"
        },
        "issuer_name": {
          "type": "string",
          "description": "Name of the insurance carrier"
        },
        "logo_url": {
          "type": "string",
          "description": "Link to a copy of the insurance carrier's logo"
        },
        "name": {
          "type": "string",
          "description": "Marketing name of the plan"
        },
        "network_size": {
          "type": "number",
          "description": "Total number of Providers in network"
        },
        "networks": {
          "type": "array",
          "description": "List of networks associated with the plan"
        },
        "plan_type": {
          "type": "string",
          "description": "Category of the plan (e.g. EPO, HMO, PPO, POS, Indemnity, PACE, Medicare-Medicaid, HMO w/POS, Cost, FFS, MSA)"
        },
        "source": {
          "type": "string",
          "description": "Source of the plan benefit data"
        },
        "stand_alone": {
          "type": "boolean",
          "description": "Stand alone flag for dental plan"
        }
      },
      "description": "Dental Plan response"
    }
  }
}

Show Plan
GET/plans/dental/{id}{?year}

Retrieving Benefits for a Dental Plan

Show the details of an individual Plan. This includes all benefits for the Plan.

For more details on displaying Plans and their related data, see the Quoting section.

URI Parameters
HideShow
id
string (required) Example: 99eA4hhn

ID of the Plan

year
number (optional) Example: 2018

Plan year (defaults to current year)


Dental Plans

POST /plans/dental/search
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "applicants": [
    {
      "age": 21,
      "child": false,
      "gender": "F"
    }
  ],
  "enrollment_date": "2019-09-17",
  "fips_code": "36081",
  "market": "individual",
  "page": 1,
  "per_page": 20,
  "providers": [
    {
      "npi": 1234567890
    }
  ],
  "zip_code": "11423"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "applicants": {
      "type": "array",
      "description": "Applicants for desired plans."
    },
    "enrollment_date": {
      "type": "string",
      "description": "Date of enrollment"
    },
    "fips_code": {
      "type": "string",
      "description": "County code to determine eligibility"
    },
    "market": {
      "type": "string",
      "description": "The audience of plan to search for. Possible values are individual, shop, small_group, medicare_advantage, large_group"
    },
    "page": {
      "type": "number",
      "description": "Selected page of paginated response."
    },
    "per_page": {
      "type": "number",
      "description": "Results per page of response."
    },
    "providers": {
      "type": "array",
      "description": "List of Provider National Practitioner Index numbers"
    },
    "zip_code": {
      "type": "string",
      "description": "5-digit zip code - this helps determine pricing."
    }
  }
}
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "plans": [
    {
      "audience": "individual",
      "benefits": {
        "bridges": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "crowns": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "denture_relines_rebases": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "denture_repair_and_adjustments": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "dentures": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "emergency_treatment": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "endodontics": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "family_annual_max": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "family_deductible": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "fluoride_treatment": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "implants": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "individual_annual_max": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "individual_deductible": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "inlays": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "onlays": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "oral_exam": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "oral_surgery": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "orthodontics_adult": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "orthodontics_child": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "periodontal_maintenance": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "periodontics": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "prophylaxis_cleaning": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "radiograph_bitewings": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "radiograph_other": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "restoration_fillings": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "sealant": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "simple_extraction": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "space_maintainers": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible"
      },
      "benefits_summary_url": "http://www.emblemhealth.com/~/media/Files/PDF/HIXHub/BenefitSummary_SelectCareSilver.pdf",
      "carrier_disclaimers": "Plan only available for companies with more than 30 employees.",
      "id": "uaLcmyru",
      "identifiers": [
        {
          "type": "contract_code",
          "value": "Identifier 1"
        }
      ],
      "in_network_ids": [
        123456789,
        234567890
      ],
      "issuer_name": "EmblemHealth",
      "logo_url": "https://d1hm12jr612u3r.cloudfront.net/images/carriers/174/1438891372/thumb.png?1438891372",
      "name": "Select Care Silver, Age 29 Rider",
      "network_size": 5000,
      "networks": [
        {
          "id": 1,
          "name": "Open Choice"
        }
      ],
      "out_of_network_ids": [
        123456789,
        234567890
      ],
      "plan_type": "HMO",
      "premium": 533.24,
      "premium_source": "carrier",
      "premium_subsidized": 321.5,
      "source": "carrier",
      "stand_alone": false
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "plans": {
      "type": "array",
      "description": "Dental plan search results"
    }
  }
}

Search Plans
POST/plans/dental/search

Searching for Dental Plans

Determine the available Plans and their Premiums for a particular Family in a given Location. The overview on dental plans and plan benefits can be accessed here.

For details on searching for Plans and their related data, see the Quoting Dental Plans section.

Provider Data

The Dental Plans are paired with Network Provider Data


Vision Plans

Vision Plans

GET /plans/vision/uaLcmyru?year=2018
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "vision_plan": {
    "audience": "individual",
    "benefits": {
      "additional_pairs_of_eyeglasses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "contact_lenses_conventional": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "contact_lenses_disposable": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "contact_lenses_medically_necessary": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "eye_exam": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "eyeglass_lenses_bifocal": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "eyeglass_lenses_lenticular": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "eyeglass_lenses_single_vision": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "eyeglass_lenses_trifocal": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "frame": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "laser_vision_correction": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "photochromatic_lenses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "polarized_lenses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "premium_antireflective_coating": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "premium_contact_lens_fit_and_follow_up": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "premium_progressive_lenses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "retinal_imaging": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "standard_antireflective_coating": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "standard_contact_lens_fit_and_follow_up": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "standard_polycarbonate_lenses_adult": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "standard_polycarbonate_lenses_child": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "standard_progressive_lenses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "standard_scratch_resistance": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "tint": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "uv_coating": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible"
    },
    "benefits_summary_url": "http://www.emblemhealth.com/~/media/Files/PDF/HIXHub/BenefitSummary_SelectCareSilver.pdf",
    "carrier_disclaimers": "Plan only available for companies with more than 30 employees.",
    "id": "uaLcmyru",
    "identifiers": [
      {
        "type": "issuer_internal_id",
        "value": "Identifier 1"
      }
    ],
    "issuer_name": "EmblemHealth",
    "logo_url": "https://d1hm12jr612u3r.cloudfront.net/images/carriers/174/1438891372/thumb.png?1438891372",
    "name": "Some Vision Plan",
    "plan_type": "PPO",
    "premium": 533.24,
    "premium_source": "carrier",
    "source": "carrier",
    "stand_alone": false
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "vision_plan": {
      "type": "object",
      "properties": {
        "audience": {
          "type": "string",
          "description": "The vision plan audience"
        },
        "benefits": {
          "type": "object",
          "properties": {
            "additional_pairs_of_eyeglasses": {
              "type": "string",
              "description": "Additional Pairs of Eyeglasses benefit string"
            },
            "contact_lenses_conventional": {
              "type": "string",
              "description": "Contact Lenses - Conventional benefit string"
            },
            "contact_lenses_disposable": {
              "type": "string",
              "description": "Contact Lenses - Disposable benefit string"
            },
            "contact_lenses_medically_necessary": {
              "type": "string",
              "description": "Contact Lenses - Medically Necessary benefit string"
            },
            "eye_exam": {
              "type": "string",
              "description": "Eye Exam benefit string"
            },
            "eyeglass_lenses_bifocal": {
              "type": "string",
              "description": "Eyeglass Lenses - Bifocal benefit string"
            },
            "eyeglass_lenses_lenticular": {
              "type": "string",
              "description": "Eyeglass Lenses - Lenticular benefit string"
            },
            "eyeglass_lenses_single_vision": {
              "type": "string",
              "description": "Eyeglass Lenses - Single Vision benefit string"
            },
            "eyeglass_lenses_trifocal": {
              "type": "string",
              "description": "Eyeglass Lenses - Trifocal benefit string"
            },
            "frame": {
              "type": "string",
              "description": "Frame benefit string"
            },
            "laser_vision_correction": {
              "type": "string",
              "description": "Laser Vision Correction benefit string"
            },
            "photochromatic_lenses": {
              "type": "string",
              "description": "Photochromatic Lenses benefit string"
            },
            "polarized_lenses": {
              "type": "string",
              "description": "Polarized Lenses benefit string"
            },
            "premium_antireflective_coating": {
              "type": "string",
              "description": "Premium Anti-Reflective Coating benefit string"
            },
            "premium_contact_lens_fit_and_follow_up": {
              "type": "string",
              "description": "Premium Contact Lens Fit and Follow-Up benefit string"
            },
            "premium_progressive_lenses": {
              "type": "string",
              "description": "Premium Progressive Lenses benefit string"
            },
            "retinal_imaging": {
              "type": "string",
              "description": "Retinal Imaging benefit string"
            },
            "standard_antireflective_coating": {
              "type": "string",
              "description": "Standard Anti-Reflective Coating benefit string"
            },
            "standard_contact_lens_fit_and_follow_up": {
              "type": "string",
              "description": "Standard Contact Lens Fit and Follow-Up benefit string"
            },
            "standard_polycarbonate_lenses_adult": {
              "type": "string",
              "description": "Standard Polycarbonate Lenses - Adult benefit string"
            },
            "standard_polycarbonate_lenses_child": {
              "type": "string",
              "description": "Standard Polycarbonate Lenses - Child benefit string"
            },
            "standard_progressive_lenses": {
              "type": "string",
              "description": "Standard Progressive Lenses benefit string"
            },
            "standard_scratch_resistance": {
              "type": "string",
              "description": "Standard Scratch-Resistance Coating benefit string"
            },
            "tint": {
              "type": "string",
              "description": "Tint benefit string"
            },
            "uv_coating": {
              "type": "string",
              "description": "UV Coating benefit string"
            }
          },
          "description": "Vision Plan Benefits"
        },
        "benefits_summary_url": {
          "type": "string",
          "description": "Link to the summary of benefits and coverage (SBC) document."
        },
        "carrier_disclaimers": {
          "type": "string",
          "description": "Most recent Disclaimer issued for this Plan"
        },
        "id": {
          "type": "string",
          "description": "The vision plan identifier"
        },
        "identifiers": {
          "type": "array",
          "description": "List of identifiers of this Plan"
        },
        "issuer_name": {
          "type": "string",
          "description": "Name of the insurance carrier"
        },
        "logo_url": {
          "type": "string",
          "description": "Link to a copy of the insurance carrier's logo"
        },
        "name": {
          "type": "string",
          "description": "The vision plan name"
        },
        "plan_type": {
          "type": "string",
          "description": "Category of the plan (e.g. EPO, HMO, PPO, POS, Indemnity, PACE,HMO w/POS, Cost, FFS, MSA)"
        },
        "premium": {
          "type": "number",
          "description": "Cumulative premium amount"
        },
        "premium_source": {
          "type": "string",
          "description": "Source of the base pricing data"
        },
        "source": {
          "type": "string",
          "description": "Source of the plan benefit data"
        },
        "stand_alone": {
          "type": "boolean",
          "description": "Stand alone flag for vision plan"
        }
      },
      "description": "Vision Plan response"
    }
  }
}

Show Plan
GET/plans/vision/{id}{?year}

Retrieving Benefits for a Vision Plan

Show the details of an individual Plan. This includes all benefits for the Plan.

For more details on displaying Plans and their related data, see the Quoting section.

URI Parameters
HideShow
id
string (required) Example: uaLcmyru

ID of the Plan

year
number (optional) Example: 2018

Plan year (defaults to current year)


Vision Plans

POST /plans/vision/search
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "applicants": [
    {
      "age": 21,
      "child": false,
      "gender": "F"
    }
  ],
  "enrollment_date": "2019-09-17",
  "fips_code": "36081",
  "market": "individual",
  "page": 1,
  "per_page": 20,
  "zip_code": "11423"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "applicants": {
      "type": "array",
      "description": "Applicants for desired plans."
    },
    "enrollment_date": {
      "type": "string",
      "description": "Date of enrollment"
    },
    "fips_code": {
      "type": "string",
      "description": "County code to determine eligibility"
    },
    "market": {
      "type": "string",
      "description": "The audience of plan to search for. Possible values are individual, shop, small_group, medicare_advantage, large_group"
    },
    "page": {
      "type": "number",
      "description": "Selected page of paginated response."
    },
    "per_page": {
      "type": "number",
      "description": "Results per page of response."
    },
    "zip_code": {
      "type": "string",
      "description": "5-digit zip code - this helps determine pricing."
    }
  }
}
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "plans": [
    {
      "audience": "individual",
      "benefits": {
        "additional_pairs_of_eyeglasses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "contact_lenses_conventional": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "contact_lenses_disposable": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "contact_lenses_medically_necessary": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "eye_exam": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "eyeglass_lenses_bifocal": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "eyeglass_lenses_lenticular": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "eyeglass_lenses_single_vision": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "eyeglass_lenses_trifocal": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "frame": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "laser_vision_correction": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "photochromatic_lenses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "polarized_lenses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "premium_antireflective_coating": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "premium_contact_lens_fit_and_follow_up": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "premium_progressive_lenses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "retinal_imaging": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "standard_antireflective_coating": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "standard_contact_lens_fit_and_follow_up": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "standard_polycarbonate_lenses_adult": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "standard_polycarbonate_lenses_child": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "standard_progressive_lenses": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "standard_scratch_resistance": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "tint": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
        "uv_coating": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible"
      },
      "benefits_summary_url": "http://www.emblemhealth.com/~/media/Files/PDF/HIXHub/BenefitSummary_SelectCareSilver.pdf",
      "carrier_disclaimers": "Plan only available for companies with more than 30 employees.",
      "id": "uaLcmyru",
      "identifiers": [
        {
          "type": "issuer_internal_id",
          "value": "Identifier 1"
        }
      ],
      "issuer_name": "EmblemHealth",
      "logo_url": "https://d1hm12jr612u3r.cloudfront.net/images/carriers/174/1438891372/thumb.png?1438891372",
      "name": "Some Vision Plan",
      "plan_type": "PPO",
      "premium": 533.24,
      "premium_source": "carrier",
      "source": "carrier",
      "stand_alone": false
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "plans": {
      "type": "array",
      "description": "Vision plan search results"
    }
  }
}

Search Plans
POST/plans/vision/search

Searching for Vision Plans

Determine the available Plans and their Premiums for a particular Family in a given Location. The overview on vision plans and plan benefits can be accessed here.

For details on searching for Plans and their related data, see the Quoting Vision Plans section.


Medicare Advantage Plans

Medicare Advantage Plans

GET /plans/medadv/H0001-001-0?year=2019
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "medicare_advantage_plan": {
    "audience": "individual",
    "benefits": {
      "ambulance": "In-Network: $300 / Out-of-Network: $300 after deductible",
      "catastrophic_brand_name": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "catastrophic_excluded": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "catastrophic_generic": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "chemotherapy_drug": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "deductible_annual_drug": "In-Network: $0 / Out-of-Network: unknown",
      "deductible_annual_medical": "In-Network: $0 / Out-of-Network: unknown",
      "dental_cleaning": "In-Network: $0 / Out-of-Network: Not Applicable",
      "dental_diagnostic_services": "In-Network: 50% / Out-of-Network: 40% after deductible",
      "dental_endodontics": "In-Network: 50% / Out-of-Network: 40% after deductible",
      "dental_exam": "In-Network: $0 / Out-of-Network: Not Applicable",
      "dental_extraction": "In-Network: $0 / Out-of-Network: Not Applicable",
      "dental_fluoride_treatment": "In-Network: 100% / Out-of-Network: 100%",
      "dental_medicare_covered_benefits": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "dental_non_routine_services": "In-Network: 100% / Out-of-Network: 100%",
      "dental_periodontics": "In-Network: 100% / Out-of-Network: 100%",
      "dental_prosthodontics_and_other": "In-Network: 100% / Out-of-Network: 100%",
      "dental_restorative_services": "In-Network: 100% / Out-of-Network: 100%",
      "dental_x_rays": "In-Network: $0 / Out-of-Network: Not Applicable",
      "diabetes_management_monitoring_supplies": "In-Network: 0%-20% / Out-of-Network: 0%-20% after deductible",
      "diagnostic_lab_service": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "diagnostic_outpatient_x_rays": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "diagnostic_radiology": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "diagnostic_test_and_procedures": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "diagnostic_therapeutic_radiology": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "doctor_visit_primary": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "doctor_visit_specialist": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "durable_medical_equipment": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "emergency_care": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "gap_brand_name": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_generic": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_generic_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_generic_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_generic_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_generic_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_generic_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_generic_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_generic_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_generic_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_non_preferred_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_non_preferred_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_non_preferred_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_non_preferred_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_non_preferred_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_non_preferred_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_non_preferred_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_non_preferred_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_brand_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_brand_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_brand_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_brand_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_brand_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_brand_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_brand_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_brand_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_generic_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_generic_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_generic_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_generic_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_generic_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_generic_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_generic_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_preferred_generic_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_specialty_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_specialty_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_specialty_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_specialty_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_specialty_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_specialty_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_specialty_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "gap_specialty_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "hearing_aids": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "hearing_aids_fitting_and_evaluation": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "hearing_exam": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "hearing_medicare_covered_benefits": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "home_health_care": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "hospice": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "initial_generic_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_generic_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_generic_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_generic_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_generic_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_generic_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_generic_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_generic_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_non_preferred_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_non_preferred_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_non_preferred_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_non_preferred_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_non_preferred_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_non_preferred_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_non_preferred_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_non_preferred_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_brand_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_brand_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_brand_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_brand_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_brand_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_brand_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_brand_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_brand_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_generic_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_generic_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_generic_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_generic_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_generic_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_generic_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_generic_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_preferred_generic_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_specialty_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_specialty_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_specialty_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_specialty_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_specialty_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_specialty_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_specialty_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "initial_specialty_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
      "inpatient_hospital": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "medical_chiropractic_services": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "medical_moop": "In-Network: $6,700 / Out-of-Network: $9,500",
      "mental_health_inpatient_visit": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "mental_health_outpatient_group_therapy": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "mental_health_outpatient_individual_therapy": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "other_part_b_drug": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "outpatient_hospital": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "physical_therapy": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "podiatry_medicare_covered_benefits": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "podiatry_routine_footcare": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "preventive_care": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "prosthetics": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "rehabilitation_occupational_therapy": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "renal_dialysis": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "routine_transportation": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "skilled_nursing_facility": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "urgent_care": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "vision_contact_lenses": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "vision_exam": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "vision_eyeglass_frames_and_lenses": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "vision_medicare_covered_benefits": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "vision_upgrades": "In-Network: 20% / Out-of-Network: 40% after deductible",
      "wellness_program": "In-Network: 20% / Out-of-Network: 40% after deductible"
    },
    "benefits_summary_url": "http://www.emblemhealth.com/~/media/Files/PDF/HIXHub/BenefitSummary_SelectCareSilver.pdf",
    "carrier_name": "EmblemHealth",
    "customer_service_phone_member": "(800)282-5366",
    "customer_service_phone_non_member": "(855)338-7027",
    "id": "uaLcmyru",
    "identifiers": [
      {
        "type": "contract_code",
        "value": "Identifier 1"
      }
    ],
    "logo_url": "https://d1hm12jr612u3r.cloudfront.net/images/carriers/174/1438891372/thumb.png?1438891372",
    "name": "Aetna Medicare Choice Plan (PPO)",
    "part_b_premium_reduction": 30.33,
    "plan_type": "Local PPO",
    "premium_drug": 533.24,
    "premium_health": 533.24,
    "source": "carrier",
    "stand_alone_part_d": false,
    "star_rating_drug_plan": 4,
    "star_rating_health_plan": 4,
    "star_rating_overall": 4,
    "supplemental_options": [
      {
        "benefits": [
          "Preventive Dental",
          "Comprehensive Dental"
        ],
        "deductible": 50,
        "id": 1,
        "moop": 1000,
        "name": "Aetna Medicare Advantage PPO Dental Plan",
        "premium": 23
      }
    ],
    "year": "2019"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "medicare_advantage_plan": {
      "type": "object",
      "properties": {
        "audience": {
          "type": "string",
          "description": "The medicare advantage plan audience"
        },
        "benefits": {
          "type": "object",
          "properties": {
            "ambulance": {
              "type": "string",
              "description": "Ambulance benefit string"
            },
            "catastrophic_brand_name": {
              "type": "string",
              "description": "Catastrophic Brand Name benefit string"
            },
            "catastrophic_excluded": {
              "type": "string",
              "description": "Catastrophic Excluded benefit string"
            },
            "catastrophic_generic": {
              "type": "string",
              "description": "Catastrophic Generic benefit string"
            },
            "chemotherapy_drug": {
              "type": "string",
              "description": "Chemotherapy Drug benefit string"
            },
            "deductible_annual_drug": {
              "type": "string",
              "description": "Deductible Annual Drug benefit string"
            },
            "deductible_annual_medical": {
              "type": "string",
              "description": "Deductible Annual Medical benefit string"
            },
            "dental_cleaning": {
              "type": "string",
              "description": "Dental Cleaning benefit string"
            },
            "dental_diagnostic_services": {
              "type": "string",
              "description": "Dental Diagnostics Services benefit string"
            },
            "dental_endodontics": {
              "type": "string",
              "description": "Dental Endodontics benefit string"
            },
            "dental_exam": {
              "type": "string",
              "description": "Dental Exam benefit string"
            },
            "dental_extraction": {
              "type": "string",
              "description": "Dental Extraction benefit string"
            },
            "dental_fluoride_treatment": {
              "type": "string",
              "description": "Dental Extraction benefit string"
            },
            "dental_medicare_covered_benefits": {
              "type": "string",
              "description": "Dental Medicare Covered Benefits benefit string"
            },
            "dental_non_routine_services": {
              "type": "string",
              "description": "Dental Non-Routine Services benefit string"
            },
            "dental_periodontics": {
              "type": "string",
              "description": "Dental Peridontics benefit string"
            },
            "dental_prosthodontics_and_other": {
              "type": "string",
              "description": "Dental Prosthodontics And Other benefit string"
            },
            "dental_restorative_services": {
              "type": "string",
              "description": "Dental Prosthodontics And Other benefit string"
            },
            "dental_x_rays": {
              "type": "string",
              "description": "Dental X-rays benefit string"
            },
            "diabetes_management_monitoring_supplies": {
              "type": "string",
              "description": "Diabetes Management Monitoring Supplies benefit string"
            },
            "diagnostic_lab_service": {
              "type": "string",
              "description": "Diagnostic Lab Service benefit string"
            },
            "diagnostic_outpatient_x_rays": {
              "type": "string",
              "description": "Diagnostic Outpatient X-rays benefit string"
            },
            "diagnostic_radiology": {
              "type": "string",
              "description": "Diagnostic Radiology benefit string"
            },
            "diagnostic_test_and_procedures": {
              "type": "string",
              "description": "Diagnostic Test and Procedures benefit string"
            },
            "diagnostic_therapeutic_radiology": {
              "type": "string",
              "description": "Diagnostic Therapeutic Radiology benefit string"
            },
            "doctor_visit_primary": {
              "type": "string",
              "description": "Doctor Visit Primary benefit string"
            },
            "doctor_visit_specialist": {
              "type": "string",
              "description": "Doctor Visit Specialist benefit string"
            },
            "durable_medical_equipment": {
              "type": "string",
              "description": "Durable Medical Equipment benefit string"
            },
            "emergency_care": {
              "type": "string",
              "description": "Emergency Care benefit string"
            },
            "gap_brand_name": {
              "type": "string",
              "description": "Gap Brand Name benefit string"
            },
            "gap_generic": {
              "type": "string",
              "description": "Gap Generic benefit string"
            },
            "gap_generic_preferred_mail_1_month": {
              "type": "string",
              "description": "Gap Generic Preferred Mail 1 Month benefit string"
            },
            "gap_generic_preferred_mail_3_month": {
              "type": "string",
              "description": "Gap Generic Preferred Mail 3 Month benefit string"
            },
            "gap_generic_preferred_retail_1_month": {
              "type": "string",
              "description": "Gap Generic Preferred Retail 1 Month benefit string"
            },
            "gap_generic_preferred_retail_3_month": {
              "type": "string",
              "description": "Gap Generic Preferred Retail 3 Month benefit string"
            },
            "gap_generic_standard_mail_1_month": {
              "type": "string",
              "description": "Gap Generic Standard Mail 1 Month benefit string"
            },
            "gap_generic_standard_mail_3_month": {
              "type": "string",
              "description": "Gap Generic Standard Mail 3 Month benefit string"
            },
            "gap_generic_standard_retail_1_month": {
              "type": "string",
              "description": "Gap Generic Standard Retail 1 Month benefit string"
            },
            "gap_generic_standard_retail_3_month": {
              "type": "string",
              "description": "Gap Generic Standard Retail 3 Month benefit string"
            },
            "gap_non_preferred_preferred_mail_1_month": {
              "type": "string",
              "description": "Gap Non-Preferred Preferred Mail 1 Month benefit string"
            },
            "gap_non_preferred_preferred_mail_3_month": {
              "type": "string",
              "description": "Gap Non-Preferred Preferred Mail 3 Month benefit string"
            },
            "gap_non_preferred_preferred_retail_1_month": {
              "type": "string",
              "description": "Gap Non-Preferred Preferred Retail 1 Month benefit string"
            },
            "gap_non_preferred_preferred_retail_3_month": {
              "type": "string",
              "description": "Gap Non-Preferred Preferred Retail 3 Month benefit string"
            },
            "gap_non_preferred_standard_mail_1_month": {
              "type": "string",
              "description": "Gap Non-Preferred Preferred Mail 1 Month benefit string"
            },
            "gap_non_preferred_standard_mail_3_month": {
              "type": "string",
              "description": "Gap Non-Preferred Standard Mail 3 Month benefit string"
            },
            "gap_non_preferred_standard_retail_1_month": {
              "type": "string",
              "description": "Gap Non-Preferred Standard Retail 1 Month benefit string"
            },
            "gap_non_preferred_standard_retail_3_month": {
              "type": "string",
              "description": "Gap Non-Preferred Standard Retail 3 Month benefit string"
            },
            "gap_preferred_brand_preferred_mail_1_month": {
              "type": "string",
              "description": "Gap Preferred Brand Preferred Mail 1 Month benefit string"
            },
            "gap_preferred_brand_preferred_mail_3_month": {
              "type": "string",
              "description": "Gap Preferred Brand Preferred Mail 3 Month benefit string"
            },
            "gap_preferred_brand_preferred_retail_1_month": {
              "type": "string",
              "description": "Gap Preferred Brand Preferred Retail 1 Month benefit string"
            },
            "gap_preferred_brand_preferred_retail_3_month": {
              "type": "string",
              "description": "Gap Preferred Brand Preferred Retail 3 Month benefit string"
            },
            "gap_preferred_brand_standard_mail_1_month": {
              "type": "string",
              "description": "Gap Preferred Brand Standard Mail 1 Month benefit string"
            },
            "gap_preferred_brand_standard_mail_3_month": {
              "type": "string",
              "description": "Gap Preferred Brand Standard Mail 3 Month benefit string"
            },
            "gap_preferred_brand_standard_retail_1_month": {
              "type": "string",
              "description": "Gap Preferred Brand Standard Retail 1 Month benefit string"
            },
            "gap_preferred_brand_standard_retail_3_month": {
              "type": "string",
              "description": "Gap Preferred Brand Standard Retail 3 Month benefit string"
            },
            "gap_preferred_generic_preferred_mail_1_month": {
              "type": "string",
              "description": "Gap Preferred Generic Preferred Mail 1 Month benefit string"
            },
            "gap_preferred_generic_preferred_mail_3_month": {
              "type": "string",
              "description": "Gap Preferred Generic Preferred Mail 3 Month benefit string"
            },
            "gap_preferred_generic_preferred_retail_1_month": {
              "type": "string",
              "description": "Gap Preferred Generic Preferred Retail 1 Month benefit string"
            },
            "gap_preferred_generic_preferred_retail_3_month": {
              "type": "string",
              "description": "Gap Preferred Generic Preferred Retail 3 Month benefit string"
            },
            "gap_preferred_generic_standard_mail_1_month": {
              "type": "string",
              "description": "Gap Preferred Generic Standard Mail 1 Month benefit string"
            },
            "gap_preferred_generic_standard_mail_3_month": {
              "type": "string",
              "description": "Gap Preferred Generic Standard Mail 3 Month benefit string"
            },
            "gap_preferred_generic_standard_retail_1_month": {
              "type": "string",
              "description": "Gap Preferred Generic Standard Retail 1 Month benefit string"
            },
            "gap_preferred_generic_standard_retail_3_month": {
              "type": "string",
              "description": "Gap Preferred Generic Standard Retail 3 Month benefit string"
            },
            "gap_specialty_preferred_mail_1_month": {
              "type": "string",
              "description": "Gap Specialty Preferred Mail 1 Month benefit string"
            },
            "gap_specialty_preferred_mail_3_month": {
              "type": "string",
              "description": "Gap Specialty Preferred Mail 3 Month benefit string"
            },
            "gap_specialty_preferred_retail_1_month": {
              "type": "string",
              "description": "Gap Specialty Preferred Retail 1 Month benefit string"
            },
            "gap_specialty_preferred_retail_3_month": {
              "type": "string",
              "description": "Gap Specialty Preferred Retail 3 Month benefit string"
            },
            "gap_specialty_standard_mail_1_month": {
              "type": "string",
              "description": "Gap Specialty Standard Mail 1 Month benefit string"
            },
            "gap_specialty_standard_mail_3_month": {
              "type": "string",
              "description": "Gap Specialty Standard Mail 3 Month benefit string"
            },
            "gap_specialty_standard_retail_1_month": {
              "type": "string",
              "description": "Gap Specialty Standard Retail 1 Month benefit string"
            },
            "gap_specialty_standard_retail_3_month": {
              "type": "string",
              "description": "Gap Specialty Standard Retail 3 Month benefit string"
            },
            "hearing_aids": {
              "type": "string",
              "description": "Hearing Aids benefit string"
            },
            "hearing_aids_fitting_and_evaluation": {
              "type": "string",
              "description": "Hearing Aids Fitting and Evaluation benefit string"
            },
            "hearing_exam": {
              "type": "string",
              "description": "Hearing Exam benefit string"
            },
            "hearing_medicare_covered_benefits": {
              "type": "string",
              "description": "Hearing Medicare Covered Benefits benefit string"
            },
            "home_health_care": {
              "type": "string",
              "description": "Home Health Care benefit string"
            },
            "hospice": {
              "type": "string",
              "description": "Hospice benefit string"
            },
            "initial_generic_preferred_mail_1_month": {
              "type": "string",
              "description": "Initial Generic Preferred Mail 1 Month benefit string"
            },
            "initial_generic_preferred_mail_3_month": {
              "type": "string",
              "description": "Initial Generic Preferred Mail 3 Month benefit string"
            },
            "initial_generic_preferred_retail_1_month": {
              "type": "string",
              "description": "Initial Generic Preferred Retail 1 Month benefit string"
            },
            "initial_generic_preferred_retail_3_month": {
              "type": "string",
              "description": "Initial Generic Preferred Retail 3 Month benefit string"
            },
            "initial_generic_standard_mail_1_month": {
              "type": "string",
              "description": "Initial Generic Standard Mail 1 Month benefit string"
            },
            "initial_generic_standard_mail_3_month": {
              "type": "string",
              "description": "Initial Generic Standard Mail 3 Month benefit string"
            },
            "initial_generic_standard_retail_1_month": {
              "type": "string",
              "description": "Initial Generic Standard Retail 1 Month benefit string"
            },
            "initial_generic_standard_retail_3_month": {
              "type": "string",
              "description": "Initial Generic Standard Retail 3 Month benefit string"
            },
            "initial_non_preferred_preferred_mail_1_month": {
              "type": "string",
              "description": "Initial Non-Preferred Preferred Mail 1 Month benefit string"
            },
            "initial_non_preferred_preferred_mail_3_month": {
              "type": "string",
              "description": "Initial Non-Preferred Preferred Mail 3 Month benefit string"
            },
            "initial_non_preferred_preferred_retail_1_month": {
              "type": "string",
              "description": "Initial Non-Preferred Preferred Retail 1 Month benefit string"
            },
            "initial_non_preferred_preferred_retail_3_month": {
              "type": "string",
              "description": "Initial Non-Preferred Preferred Retail 3 Month benefit string"
            },
            "initial_non_preferred_standard_mail_1_month": {
              "type": "string",
              "description": "Initial Non-Preferred Preferred Mail 1 Month benefit string"
            },
            "initial_non_preferred_standard_mail_3_month": {
              "type": "string",
              "description": "Initial Non-Preferred Standard Mail 3 Month benefit string"
            },
            "initial_non_preferred_standard_retail_1_month": {
              "type": "string",
              "description": "Initial Non-Preferred Standard Retail 1 Month benefit string"
            },
            "initial_non_preferred_standard_retail_3_month": {
              "type": "string",
              "description": "Initial Non-Preferred Standard Retail 3 Month benefit string"
            },
            "initial_preferred_brand_preferred_mail_1_month": {
              "type": "string",
              "description": "Initial Preferred Brand Preferred Mail 1 Month benefit string"
            },
            "initial_preferred_brand_preferred_mail_3_month": {
              "type": "string",
              "description": "Initial Preferred Brand Preferred Mail 3 Month benefit string"
            },
            "initial_preferred_brand_preferred_retail_1_month": {
              "type": "string",
              "description": "Initial Preferred Brand Preferred Retail 1 Month benefit string"
            },
            "initial_preferred_brand_preferred_retail_3_month": {
              "type": "string",
              "description": "Initial Preferred Brand Preferred Retail 3 Month benefit string"
            },
            "initial_preferred_brand_standard_mail_1_month": {
              "type": "string",
              "description": "Initial Preferred Brand Standard Mail 1 Month benefit string"
            },
            "initial_preferred_brand_standard_mail_3_month": {
              "type": "string",
              "description": "Initial Preferred Brand Standard Mail 3 Month benefit string"
            },
            "initial_preferred_brand_standard_retail_1_month": {
              "type": "string",
              "description": "Initial Preferred Brand Standard Retail 1 Month benefit string"
            },
            "initial_preferred_brand_standard_retail_3_month": {
              "type": "string",
              "description": "Initial Preferred Brand Standard Retail 3 Month benefit string"
            },
            "initial_preferred_generic_preferred_mail_1_month": {
              "type": "string",
              "description": "Initial Preferred Generic Preferred Mail 1 Month benefit string"
            },
            "initial_preferred_generic_preferred_mail_3_month": {
              "type": "string",
              "description": "Initial Preferred Generic Preferred Mail 3 Month benefit string"
            },
            "initial_preferred_generic_preferred_retail_1_month": {
              "type": "string",
              "description": "Initial Preferred Generic Preferred Retail 1 Month benefit string"
            },
            "initial_preferred_generic_preferred_retail_3_month": {
              "type": "string",
              "description": "Initial Preferred Generic Preferred Retail 3 Month benefit string"
            },
            "initial_preferred_generic_standard_mail_1_month": {
              "type": "string",
              "description": "Initial Preferred Generic Standard Mail 1 Month benefit string"
            },
            "initial_preferred_generic_standard_mail_3_month": {
              "type": "string",
              "description": "Initial Preferred Generic Standard Mail 3 Month benefit string"
            },
            "initial_preferred_generic_standard_retail_1_month": {
              "type": "string",
              "description": "Initial Preferred Generic Standard Retail 1 Month benefit string"
            },
            "initial_preferred_generic_standard_retail_3_month": {
              "type": "string",
              "description": "Initial Preferred Generic Standard Retail 3 Month benefit string"
            },
            "initial_specialty_preferred_mail_1_month": {
              "type": "string",
              "description": "Initial Specialty Preferred Mail 1 Month benefit string"
            },
            "initial_specialty_preferred_mail_3_month": {
              "type": "string",
              "description": "Initial Specialty Preferred Mail 3 Month benefit string"
            },
            "initial_specialty_preferred_retail_1_month": {
              "type": "string",
              "description": "Initial Specialty Preferred Retail 1 Month benefit string"
            },
            "initial_specialty_preferred_retail_3_month": {
              "type": "string",
              "description": "Initial Specialty Preferred Retail 3 Month benefit string"
            },
            "initial_specialty_standard_mail_1_month": {
              "type": "string",
              "description": "Initial Specialty Standard Mail 1 Month benefit string"
            },
            "initial_specialty_standard_mail_3_month": {
              "type": "string",
              "description": "Initial Specialty Standard Mail 3 Month benefit string"
            },
            "initial_specialty_standard_retail_1_month": {
              "type": "string",
              "description": "Initial Specialty Standard Retail 1 Month benefit string"
            },
            "initial_specialty_standard_retail_3_month": {
              "type": "string",
              "description": "Initial Specialty Standard Retail 3 Month benefit string"
            },
            "inpatient_hospital": {
              "type": "string",
              "description": "Inpatient Hospital benefit string"
            },
            "medical_chiropractic_services": {
              "type": "string",
              "description": "Medical Chiropractic Services benefit string"
            },
            "medical_moop": {
              "type": "string",
              "description": "Medical Medicare Advantage Maxiumum Out-Of-Pocket benefit string"
            },
            "mental_health_inpatient_visit": {
              "type": "string",
              "description": "Medical Medicare Advantage Maxiumum Out-Of-Pocket benefit string"
            },
            "mental_health_outpatient_group_therapy": {
              "type": "string",
              "description": "Medical Health Outpatient Group Therapy benefit string"
            },
            "mental_health_outpatient_individual_therapy": {
              "type": "string",
              "description": "Medical Health Outpatient Individual Therapy benefit string"
            },
            "other_part_b_drug": {
              "type": "string",
              "description": "Other Part B Drug benefit string"
            },
            "outpatient_hospital": {
              "type": "string",
              "description": "Outpatient Hospital benefit string"
            },
            "physical_therapy": {
              "type": "string",
              "description": "Physical Therapy benefit string"
            },
            "podiatry_medicare_covered_benefits": {
              "type": "string",
              "description": "Podiatry Medicare Covered Benefits benefit string"
            },
            "podiatry_routine_footcare": {
              "type": "string",
              "description": "Podiatry Routine Footcare benefit string"
            },
            "preventive_care": {
              "type": "string",
              "description": "Preventive Care benefit string"
            },
            "prosthetics": {
              "type": "string",
              "description": "Prosthetics benefit string"
            },
            "rehabilitation_occupational_therapy": {
              "type": "string",
              "description": "Rehabilitation Occupational Therapy benefit string"
            },
            "renal_dialysis": {
              "type": "string",
              "description": "Rehabilitation Occupational Therapy benefit string"
            },
            "routine_transportation": {
              "type": "string",
              "description": "Rehabilitation Occupational Therapy benefit string"
            },
            "skilled_nursing_facility": {
              "type": "string",
              "description": "Skilled Nursing Facility benefit string"
            },
            "urgent_care": {
              "type": "string",
              "description": "Urgent Care benefit string"
            },
            "vision_contact_lenses": {
              "type": "string",
              "description": "Vision Contact Lenses benefit string"
            },
            "vision_exam": {
              "type": "string",
              "description": "Vision Exam benefit string"
            },
            "vision_eyeglass_frames_and_lenses": {
              "type": "string",
              "description": "Vision Eyeglasses Frames and Lenses benefit string"
            },
            "vision_medicare_covered_benefits": {
              "type": "string",
              "description": "Vision Medicare Covered Benefits benefit string"
            },
            "vision_upgrades": {
              "type": "string",
              "description": "Vision Upgrades benefit string"
            },
            "wellness_program": {
              "type": "string",
              "description": "Wellness Program benefit string"
            }
          },
          "description": "Medicare Advantage Plan Benefits"
        },
        "benefits_summary_url": {
          "type": "string",
          "description": "Link to the summary of benefits and coverage (SBC) document."
        },
        "carrier_name": {
          "type": "string",
          "description": "Name of the insurance carrier"
        },
        "customer_service_phone_member": {
          "type": "string",
          "description": "Customer Service member phone number"
        },
        "customer_service_phone_non_member": {
          "type": "string",
          "description": "Customer_service for non-member phone number"
        },
        "id": {
          "type": "string",
          "description": "The dental plan identifier"
        },
        "identifiers": {
          "type": "array",
          "description": "List of identifiers of this Plan"
        },
        "logo_url": {
          "type": "string",
          "description": "Link to a copy of the insurance carrier's logo"
        },
        "name": {
          "type": "string",
          "description": "The medicare advantage plan name"
        },
        "part_b_premium_reduction": {
          "type": "number",
          "description": "Part B premium reduction amount"
        },
        "plan_type": {
          "type": "string",
          "description": "The type of medicare advantage plan"
        },
        "premium_drug": {
          "type": "number",
          "description": "Cumulative premium amount"
        },
        "premium_health": {
          "type": "number",
          "description": "Cumulative premium amount"
        },
        "source": {
          "type": "string",
          "description": "Source of the medicare advantage plan benefit data"
        },
        "stand_alone_part_d": {
          "type": "boolean",
          "description": "Stand alone flag for medical advantage plan"
        },
        "star_rating_drug_plan": {
          "type": "number",
          "description": "Star rating for the drug medicare advantage plan"
        },
        "star_rating_health_plan": {
          "type": "number",
          "description": "Star rating for the medical medicare advantage plan"
        },
        "star_rating_overall": {
          "type": "number",
          "description": "Overall star rating for the plan"
        },
        "supplemental_options": {
          "type": "array",
          "description": "List of supplemental options of this Plan"
        },
        "year": {
          "type": "string",
          "description": "The year of medicare advantage plan"
        }
      },
      "description": "Medicare Advantage Plan response"
    }
  }
}

Show Plan
GET/plans/medadv/{id}{?year}

Retrieving Benefits for a Medicare Advantage Plan

Show the details of an individual Medicare Advantage Plan.

Prescription drug benefits

Initial coverage phase and gap phase are each broken down by 5 drug tiers (generic, non-preferred, preferred-brand, preferred-generic, and specialty), 4 pharmacy tiers (preferred mail, preferred retail, standard mail, and standard retail), and 2 lengths of supply (1-month and 3-month.) If there is no additional coverage during coverage gap phase, then cost sharing in this phase may be presented in just 2 fields - gap_brand_name and gap_generic, instead of broken-down benefits as described above. For a description of each drug benefit field, please see the schema on the right side.

URI Parameters
HideShow
id
string (required) Example: H0001-001-0

ID of the Plan

year
number (optional) Example: 2019

Plan year (defaults to current year)


Medicare Advantage Plans

POST /plans/medadv/search
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "drug_packages": [
    {
      "id": "01002-1200-11",
      "med_id": 1
    }
  ],
  "enrollment_date": "2019-09-17",
  "fips_code": "36081",
  "page": 1,
  "per_page": 20,
  "providers": [
    {
      "npi": 1234567890
    }
  ],
  "zip_code": "11423"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "drug_packages": {
      "type": "array",
      "description": "National Drug Code Package Id"
    },
    "enrollment_date": {
      "type": "string",
      "description": "Date of enrollment"
    },
    "fips_code": {
      "type": "string",
      "description": "County code for the geographic area of the search"
    },
    "page": {
      "type": "number",
      "description": "Selected page of paginated response."
    },
    "per_page": {
      "type": "number",
      "description": "Results per page of response."
    },
    "providers": {
      "type": "array",
      "description": "List of providers to search for."
    },
    "zip_code": {
      "type": "string",
      "description": "Zip code for the geographic area of the search"
    }
  }
}
Responses200
Headers
Content-Type: application/json
Body
{
  "coverages": [
    {
      "plan_id": "88582NY0230001",
      "prior_authorization": true,
      "quantity_limit": true,
      "step_therapy": true,
      "tier": "generic"
    }
  ],
  "meta": {
    "total": 10
  },
  "plans": [
    {
      "audience": "individual",
      "benefits": {
        "ambulance": "In-Network: $300 / Out-of-Network: $300 after deductible",
        "catastrophic_brand_name": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "catastrophic_excluded": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "catastrophic_generic": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "chemotherapy_drug": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "deductible_annual_drug": "In-Network: $0 / Out-of-Network: unknown",
        "deductible_annual_medical": "In-Network: $0 / Out-of-Network: unknown",
        "dental_cleaning": "In-Network: $0 / Out-of-Network: Not Applicable",
        "dental_diagnostic_services": "In-Network: 50% / Out-of-Network: 40% after deductible",
        "dental_endodontics": "In-Network: 50% / Out-of-Network: 40% after deductible",
        "dental_exam": "In-Network: $0 / Out-of-Network: Not Applicable",
        "dental_extraction": "In-Network: $0 / Out-of-Network: Not Applicable",
        "dental_fluoride_treatment": "In-Network: 100% / Out-of-Network: 100%",
        "dental_medicare_covered_benefits": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "dental_non_routine_services": "In-Network: 100% / Out-of-Network: 100%",
        "dental_periodontics": "In-Network: 100% / Out-of-Network: 100%",
        "dental_prosthodontics_and_other": "In-Network: 100% / Out-of-Network: 100%",
        "dental_restorative_services": "In-Network: 100% / Out-of-Network: 100%",
        "dental_x_rays": "In-Network: $0 / Out-of-Network: Not Applicable",
        "diabetes_management_monitoring_supplies": "In-Network: 0%-20% / Out-of-Network: 0%-20% after deductible",
        "diagnostic_lab_service": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "diagnostic_outpatient_x_rays": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "diagnostic_radiology": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "diagnostic_test_and_procedures": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "diagnostic_therapeutic_radiology": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "doctor_visit_primary": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "doctor_visit_specialist": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "durable_medical_equipment": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "emergency_care": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "gap_brand_name": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_generic": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_generic_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_generic_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_generic_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_generic_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_generic_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_generic_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_generic_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_generic_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_non_preferred_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_non_preferred_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_non_preferred_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_non_preferred_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_non_preferred_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_non_preferred_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_non_preferred_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_non_preferred_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_brand_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_brand_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_brand_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_brand_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_brand_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_brand_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_brand_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_brand_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_generic_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_generic_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_generic_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_generic_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_generic_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_generic_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_generic_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_preferred_generic_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_specialty_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_specialty_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_specialty_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_specialty_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_specialty_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_specialty_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_specialty_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "gap_specialty_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "hearing_aids": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "hearing_aids_fitting_and_evaluation": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "hearing_exam": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "hearing_medicare_covered_benefits": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "home_health_care": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "hospice": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "initial_generic_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_generic_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_generic_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_generic_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_generic_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_generic_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_generic_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_generic_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_non_preferred_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_non_preferred_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_non_preferred_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_non_preferred_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_non_preferred_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_non_preferred_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_non_preferred_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_non_preferred_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_brand_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_brand_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_brand_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_brand_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_brand_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_brand_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_brand_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_brand_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_generic_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_generic_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_generic_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_generic_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_generic_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_generic_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_generic_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_preferred_generic_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_specialty_preferred_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_specialty_preferred_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_specialty_preferred_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_specialty_preferred_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_specialty_standard_mail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_specialty_standard_mail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_specialty_standard_retail_1_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "initial_specialty_standard_retail_3_month": "In-Network: $40 / Out-of-Network: 40% after deductible",
        "inpatient_hospital": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "medical_chiropractic_services": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "medical_moop": "In-Network: $6,700 / Out-of-Network: $9,500",
        "mental_health_inpatient_visit": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "mental_health_outpatient_group_therapy": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "mental_health_outpatient_individual_therapy": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "other_part_b_drug": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "outpatient_hospital": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "physical_therapy": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "podiatry_medicare_covered_benefits": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "podiatry_routine_footcare": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "preventive_care": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "prosthetics": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "rehabilitation_occupational_therapy": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "renal_dialysis": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "routine_transportation": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "skilled_nursing_facility": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "urgent_care": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "vision_contact_lenses": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "vision_exam": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "vision_eyeglass_frames_and_lenses": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "vision_medicare_covered_benefits": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "vision_upgrades": "In-Network: 20% / Out-of-Network: 40% after deductible",
        "wellness_program": "In-Network: 20% / Out-of-Network: 40% after deductible"
      },
      "benefits_summary_url": "http://www.emblemhealth.com/~/media/Files/PDF/HIXHub/BenefitSummary_SelectCareSilver.pdf",
      "carrier_name": "EmblemHealth",
      "customer_service_phone_member": "(800)282-5366",
      "customer_service_phone_non_member": "(855)338-7027",
      "id": "uaLcmyru",
      "identifiers": [
        {
          "type": "contract_code",
          "value": "Identifier 1"
        }
      ],
      "in_network_ids": [
        123456789,
        234567890
      ],
      "logo_url": "https://d1hm12jr612u3r.cloudfront.net/images/carriers/174/1438891372/thumb.png?1438891372",
      "name": "Aetna Medicare Choice Plan (PPO)",
      "out_of_network_ids": [
        123456789,
        234567890
      ],
      "part_b_premium_reduction": 30.33,
      "plan_type": "Local PPO",
      "premium_drug": 533.24,
      "premium_health": 533.24,
      "source": "carrier",
      "stand_alone_part_d": false,
      "star_rating_drug_plan": 4,
      "star_rating_health_plan": 4,
      "star_rating_overall": 4,
      "supplemental_options": [
        {
          "benefits": [
            "Preventive Dental",
            "Comprehensive Dental"
          ],
          "deductible": 50,
          "id": 1,
          "moop": 1000,
          "name": "Aetna Medicare Advantage PPO Dental Plan",
          "premium": 23
        }
      ],
      "year": "2019"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "coverages": {
      "type": "array",
      "description": "Coverages associated with the plan."
    },
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "plans": {
      "type": "array",
      "description": "Medicare Advantage plan search results"
    }
  }
}

Search Plans
POST/plans/medadv/search

Searching for Medicare Advantage Plans

Quoting medicare advantage plans for an individual only requires location (zip and fips codes) and enrollment date.

Provider Data

The Medicare Advantage Plans are paired with Network Provider Data

Drug coverages

Are included along with the rest of the plan data. See the description below for more details.


Bulk Plans

Bulk Plans

POST /plans/bulk
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "market": "small_group",
  "page": 1,
  "per_page": 20,
  "product_line": "medical",
  "state": "NY",
  "year": "2017"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "description": "The market for which the plans are offered, options are: individual or small group."
    },
    "page": {
      "type": "number",
      "description": "Selected page of paginated response."
    },
    "per_page": {
      "type": "number",
      "description": "Results per page of response."
    },
    "product_line": {
      "type": "string",
      "description": "The line of coverage, options are: medical, dental, or vision."
    },
    "state": {
      "type": "string",
      "description": "The two-letter state code where the plans are offered."
    },
    "year": {
      "type": "string",
      "description": "The year when the plans are offered."
    }
  }
}
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "plans": [
    {
      "abortion_rider": false,
      "actuarial_value": 80,
      "adult_dental": true,
      "age29_rider": false,
      "ambulance": "In-Network: 25% after deductible / Out-of-Network: 25% after deductible",
      "benefits_summary_url": "http://www.emblemhealth.com/~/media/Files/PDF/HIXHub/BenefitSummary_SelectCareSilver.pdf",
      "buy_link": "http://www.healthbenefitexchange.ny.gov/",
      "carrier_disclaimers": "Plan only available for companies with more than 30 employees.",
      "carrier_name": "EmblemHealth",
      "child_dental": "In-Network: $0 / Out-of-Network: 100%",
      "child_eye_exam": "In-Network: $0 / Out-of-Network: 100%",
      "child_eyewear": "In-Network: $0 / Out-of-Network: 100%",
      "chiropractic_services": false,
      "coinsurance": 20,
      "customer_service_phone_number": "1-866-640-3889",
      "diagnostic_test": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "display_name": "Aetna PPO 20/5000",
      "dp_rider": true,
      "drug_formulary_url": "http://www.emblemhealth.com/~/media/Files/PDF/Pharmacy/ValuePlus_Formulary.pdf",
      "durable_medical_equipment": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "effective_date": "2017-01-01",
      "embedded_deductible": "non_embedded",
      "emergency_room": "Deductible, then $150",
      "essential_health_benefits_percentage": 1,
      "expiration_date": "2017-12-31",
      "family_drug_deductible": "Included in Medical",
      "family_drug_moop": "Included in Medical",
      "family_medical_deductible": "$4,000",
      "family_medical_moop": "$11,000",
      "fp_rider": true,
      "gated": false,
      "generic_drugs": "$10",
      "habilitation_services": "In-Network: $0 / Out-of-Network: 100%",
      "hios_issuer_id": "1",
      "home_health_care": "In-Network: $0 / Out-of-Network: 100%",
      "hospice_service": "In-Network: $0 / Out-of-Network: 100%",
      "hsa_eligible": false,
      "id": "88582NY0230001",
      "identifiers": [
        {
          "type": "contract_code",
          "value": "Identifier 1"
        }
      ],
      "imaging": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "imaging_center": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "imaging_physician": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "individual_drug_deductible": "Included in Medical",
      "individual_drug_moop": "Included in Medical",
      "individual_medical_deductible": "$2,000",
      "individual_medical_moop": "$5,500",
      "infertility_treatment_rider": false,
      "inpatient_birth": "In-Network: $0 / Out-of-Network: 100%",
      "inpatient_birth_physician": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "inpatient_facility": "Deductible, then $1,500 per admission\"",
      "inpatient_mental_health": "In-Network: $0 / Out-of-Network: 100%",
      "inpatient_physician": "Included in inpatient facility",
      "inpatient_substance": "In-Network: $0 / Out-of-Network: 100%",
      "lab_test": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "level": "silver",
      "logo_url": "https://d1hm12jr612u3r.cloudfront.net/images/carriers/174/1438891372/thumb.png?1438891372",
      "mail_order_rx": 1.5,
      "name": "Select Care Silver, Age 29 Rider",
      "network_ids": [
        1,
        3
      ],
      "network_size": 5000,
      "networks": [
        {
          "id": 1,
          "name": "Open Choice"
        }
      ],
      "non_preferred_brand_drugs": "$70",
      "nonpreferred_generic_drug_share": "$70",
      "nonpreferred_specialty_drug_share": "$70",
      "off_market": false,
      "on_market": true,
      "out_of_network_coverage": false,
      "outpatient_ambulatory_care_center": "In-Network: 25% after deductible / Out-of-Network: 100%",
      "outpatient_facility": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "outpatient_mental_health": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "outpatient_physician": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "outpatient_substance": "In-Network: $0 / Out-of-Network: 100%",
      "plan_ancestors": [
        {
          "id": "Identifier 1",
          "year": 2019
        }
      ],
      "plan_calendar": "calendar_year",
      "plan_coinsurance": "In-Network: 30% after deductible / Out-of-Network: 50% after deductible",
      "plan_market": "shop",
      "plan_type": "HMO",
      "postnatal_care": "In-Network: $0 / Out-of-Network: 100%",
      "preferred_brand_drugs": "$35",
      "prenatal_care": "In-Network: $0 / Out-of-Network: 100%",
      "prenatal_postnatal_care": "In-Network: $0 / Out-of-Network: 100%",
      "preventative_care": "In-Network: $0 / Out-of-Network: 100%",
      "primary_care_physician": "Deductible, then $30",
      "rehabilitation_services": "In-Network: $0 / Out-of-Network: 100%",
      "service_area_id": "11234-2016-WI01",
      "skilled_nursing": "In-Network: $0 / Out-of-Network: 100%",
      "skilled_nursing_facility_365": "unlimited",
      "source": "carrier",
      "specialist": "Deductible, then $50",
      "specialty_drugs": "$70",
      "telemedicine": false,
      "type": "ACAPlan2018",
      "updated_at": "2016-01-01",
      "urgent_care": "In-Network: $0 / Out-of-Network: 100%"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "plans": {
      "type": "array",
      "description": "Plan search results"
    }
  }
}

Plans in Bulk
POST/plans/bulk

Retrieve plan benefit data in bulk

Use this endpoint to get plan information in bulk by state, market, year, and product line.

Notice: Please note that there are potential breaking changes in the 2020 ACA medical plan schema. For backwards compatibility, the previous schema will be maintained for plans before the 2020 plan year until January 2, 2020. For more information, please see our 2020 ACA Medical Plan Data Update.

Parameters

Field Type Notes
market
(required)
string The options are individual or small_group.
state
(required)
string The two-letter state code where the plans are offered.
product_line
(required)
string The options are medical, dental, or vision.
year
(required)
string

Providers

Providers

POST /providers/search
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Body
{
  "accepts_insurance": true,
  "ids": [
    1013955475,
    1558302844
  ],
  "network_ids": [
    200251
  ],
  "page": 1,
  "per_page": 2,
  "plan_ids": [
    "99eA4hhn",
    "88582NY0230001",
    "H3328-003-0"
  ],
  "polygon": 1,
  "radius": 1,
  "search_term": "Hello, world!",
  "sort": "distance",
  "sort_seed": 1,
  "specialty_ids": [
    "0b1a7a567e",
    "4c12f8d69a",
    "41c2491831"
  ],
  "type": "individual",
  "zip_code": "11423"
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "accepts_insurance": {
      "type": "boolean",
      "description": "Limit results to Providers who accept at least one insurance plan. Note that the inverse of this filter is not supported and any value will evaluate to true"
    },
    "ids": {
      "type": "array",
      "description": "List of NPIs"
    },
    "network_ids": {
      "type": "array",
      "description": "List of Vericred network ids"
    },
    "page": {
      "type": "number",
      "description": "Page number"
    },
    "per_page": {
      "type": "number",
      "description": "Number of records to return per page"
    },
    "plan_ids": {
      "type": "array",
      "description": "List of Vericred IDs, HIOS ids and Medicare contract codes"
    },
    "polygon": {
      "type": "number",
      "description": "Define a custom search polygon, mutually exclusive with zip_code search"
    },
    "radius": {
      "type": "number",
      "description": "Radius (in miles) to use to limit results"
    },
    "search_term": {
      "type": "string",
      "description": "String to search by"
    },
    "sort": {
      "type": "string",
      "description": "specify sort mode (distance or random)"
    },
    "sort_seed": {
      "type": "number",
      "description": "Seed value for random sort. Randomly-ordered searches with the same seed return results in consistent order."
    },
    "specialty_ids": {
      "type": "array",
      "description": "List of Specialty ids"
    },
    "type": {
      "type": "string",
      "description": "Either organization or individual"
    },
    "zip_code": {
      "type": "string",
      "description": "Zip Code to search near"
    }
  },
  "required": [
    "search_term",
    "zip_code"
  ]
}
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "providers": [
    {
      "city": "New York",
      "email": "doctorx@example.com",
      "first_name": "John",
      "gender": "F",
      "id": 1234567890,
      "last_name": "Smith",
      "latitude": 45.55,
      "longitude": 14.55,
      "middle_name": "Danger",
      "network_ids": [
        200251
      ],
      "npis": [
        1234567890
      ],
      "organization_name": "Vericred Inc",
      "phone": "2125558700",
      "presentation_name": "Dr. John D. Smith Jr.",
      "specialty": "Internal Medicine",
      "state": "NY",
      "state_id": 1,
      "street_line_1": "123 Fake Street",
      "street_line_2": "Apt 10",
      "suffix": "Jr.",
      "title": "Dr.",
      "type": "organization",
      "zip_code": "11215"
    }
  ],
  "states": [
    {
      "code": "NY",
      "fips_number": "36",
      "id": 37,
      "last_date_for_individual": "2019-12-31",
      "last_date_for_shop": "2019-12-31",
      "live_for_business": true,
      "live_for_consumers": true,
      "name": "New York"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "providers": {
      "type": "array",
      "description": "Providers that fit the requested criterion."
    },
    "states": {
      "type": "array",
      "description": "States that fit the requested criterion."
    }
  }
}

Find Providers
POST/providers/search

Provider Details

All searches can take a search_term, which is used as a component in the score (and thus the ranking/order) of the results. This is combined with the proximity to the location in ranking results. For example, we would want “Dr. John Smith” who is 5 miles away from a given Zip Code to appear before “Dr. John Smith” who is 100 miles away.

The weighting also allows for non-exact matches. In our prior example, we would want “Dr. Jon Smith” who is 2 miles away to appear before the exact match “Dr. John Smith” who is 100 miles away because it is more likely that the user just entered an incorrect name.

The free text search also supports Specialty name search and “body part” Specialty name search. So, searching “John Smith nose” would return “Dr. John Smith”, the ENT Specialist before “Dr. John Smith” the Internist.

In addition, we can filter Providers by whether or not they accept any insurance. Our data set includes over 4 million Providers, some of whom do not accept any insurance at all. This filter makes it more likely that the user will find his or her practitioner in some cases.

Location Information

All Provider searches that do not specify plan_ids or network_idsrequire some type of location information. We use this information either to weight results or to filter results, depending on the type.

Network IDs

This endpoint supports filtering provider search results to only those that are in-network for specific provider networks. To do so, you can provide a network_ids key in the request that includes a list of the identifiers for each network to filter on. Please note that the network_ids response key will only appear if it is used in the request. The use of this filter is reserved for paying customers.

Zip Code

When providing the zip_code parameter, we order the Providers returned based on their score, which incorporates their proximity to the given Zip Code and the closeness of match to the search text. If a radius is also provided, we filter out Providers who are outside of that radius from the center of the Zip Code provided.

Polygon

When providing the polygon parameter, we filter providers who are outside the bounds of the shape provided. This is mutually exclusive with zip_code and radius.

Specialty

When providing the specialty_ids parameter, we filter providers to those who practice those specialties. To find the specialty_ids, please use the Specialty Search endpoint.

Plan/Network Information

We can also filter based on Plan and Network participation, using plan_ids and network_ids, respectively. These filters are mutually exclusive and return the union of the resulting sets for each Plan or Network. I.e. if you provider Plan A and Plan B, you will receive Providers who accept either Plan. The same is true for Networks. The plan identifiers filter supports: Vericred plan IDs returned from the Dental and Vision endpoints, as well as, HIOS IDs and Medicare contract codes.

Examples

Find Dr. Foo near Brooklyn

{ "search_term": "Foo", "zip_code": "11215" }

Find all Providers within 5 miles of Brooklyn who accept a Plan

{ "zip_code": "11215", "radius": 5, "plan_ids": ["88582NY0230001"] }

Find all providers on a map of Brooklyn ordered by a combination of proximity to the center point of the map and relevance to the search term “ENT”

{
  "polygon": [
      {"lon":-74.0126609802,"lat":40.6275684851 },
      {"lon":-74.0126609802,"lat":40.7097269508 },
      {"lon":-73.9367866516,"lat":40.7097269508 },
      {"lon":-73.9367866516,"lat":40.6275684851 }
  ],
  "search_term" : "ENT"
}

Providers

GET /providers/1234567890?year=2016&state=NY
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "provider": {
    "city": "New York",
    "email": "doctorx@example.com",
    "first_name": "John",
    "gender": "F",
    "id": 1234567890,
    "last_name": "Smith",
    "latitude": 45.55,
    "longitude": 14.55,
    "middle_name": "Danger",
    "network_ids": [
      1
    ],
    "npis": [
      1234567890
    ],
    "organization_name": "Vericred Inc",
    "phone": "2125558700",
    "presentation_name": "Dr. John D. Smith Jr.",
    "specialty": "Internal Medicine",
    "state": "NY",
    "state_id": 1,
    "street_line_1": "123 Fake Street",
    "street_line_2": "Apt 10",
    "suffix": "Jr.",
    "title": "Dr.",
    "type": "organization",
    "zip_code": "11215"
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "provider": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string",
          "description": "City name (e.g. Springfield)."
        },
        "email": {
          "type": "string",
          "description": "Primary email address to contact the provider."
        },
        "first_name": {
          "type": "string",
          "description": "Given name for the provider."
        },
        "gender": {
          "type": "string",
          "description": "Provider's gender (M or F)"
        },
        "id": {
          "type": "number",
          "description": "National Provider Index (NPI) number"
        },
        "last_name": {
          "type": "string",
          "description": "Family name for the provider."
        },
        "latitude": {
          "type": "number",
          "description": "Latitude of provider"
        },
        "longitude": {
          "type": "number",
          "description": "Longitude of provider"
        },
        "middle_name": {
          "type": "string",
          "description": "Middle name for the provider."
        },
        "network_ids": {
          "type": "array",
          "description": "Array of network ids"
        },
        "npis": {
          "type": "array",
          "description": "The National Provider Index (NPI) numbers associated with this provider."
        },
        "organization_name": {
          "type": "string",
          "description": "name for the providers of type: organization."
        },
        "phone": {
          "type": "string",
          "description": "Office phone for the provider"
        },
        "presentation_name": {
          "type": "string",
          "description": "Preferred name for display (e.g. Dr. Francis White may prefer Dr. Frank White)"
        },
        "specialty": {
          "type": "string",
          "description": "Name of the primary Specialty"
        },
        "state": {
          "type": "string",
          "description": "State code for the provider's address (e.g. NY)."
        },
        "state_id": {
          "type": "number",
          "description": "Foreign key to States"
        },
        "street_line_1": {
          "type": "string",
          "description": "First line of the provider's street address."
        },
        "street_line_2": {
          "type": "string",
          "description": "Second line of the provider's street address."
        },
        "suffix": {
          "type": "string",
          "description": "Suffix for the provider's name (e.g. Jr)"
        },
        "title": {
          "type": "string",
          "description": "Professional title for the provider (e.g. Dr)."
        },
        "type": {
          "type": "string",
          "description": "Type of NPI number (individual provider vs organization)."
        },
        "zip_code": {
          "type": "string",
          "description": "Postal code for the provider's address (e.g. 11215)"
        }
      },
      "description": "The requested provider."
    }
  }
}

Find a Provider
GET/providers/{npi}{?year,state}

To retrieve a specific provider, just perform a GET using his NPI number.

New Verison: The hios_ids response key has been deprecated in version 7 of the API (v7). To get plan information in the latest version, please use the Provider Plans endpoint GET /providers/:npi/plans.

URI Parameters
HideShow
npi
string (required) Example: 1234567890

NPI number

year
string (optional) Example: 2016

Only show plan ids for the given year

state
string (optional) Example: NY

Only show plan ids for the given state


Providers

GET /providers/1234567890/plans?line_of_coverage=medical&year=2019&market=small_group
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "plans": [
    {
      "carrier_name": "Aetna",
      "external_ids": [
        {
          "type": "contract_code",
          "value": "Identifier 1"
        }
      ],
      "id": "88582NY0230001",
      "line_of_coverage": "medical",
      "market": "small_group",
      "name": "Aetna PPO 20/5000",
      "networks": [
        {
          "name": "Open Choice",
          "tier": "Tier 1"
        }
      ]
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "plans": {
      "type": "array",
      "description": "Provider plan search results"
    }
  }
}

Provider Plans
GET/providers/{npi}/plans{?line_of_coverage,year,market}

Retrieve the plans a provider accepts.

New Verison: In order to use this endpoint, please set your version header to v7. If you are using previous versions and want to get the list of plan_ids that a provider accepts, you can use the hios_ids key in the Provider Show GET /providers/:npi endpoint.

External Id Types

Plan external_ids are returned as a list, with each item containing both a type and a value. Below is a list of possible types:

Type Description
hios_id The HIOS ID of the plan. This type will be returned for under-65 ACA medical plans.
contract_id A contract identifier for the plan. This will be returned for all Medicare Advantage plans and any other plan that contains external contract ids.
package_code A package code for the plan. This value will be returned if there is a package in which the plan is bundled.
URI Parameters
HideShow
npi
string (required) Example: 1234567890

NPI number

line_of_coverage
string (required) Example: medical

The line of coverage the plans are in. Options are medical, medicare_advantage, dental, or vision.

year
string (required) Example: 2019

The year the plans are effective in.

market
string (optional) Example: small_group

The market the plans are for. Options are individual, small_group, large_group.


Specialties

Specialties

GET /specialties?search_term=Anesthesiology&code=207LC0200X&page=1&per_page=1
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "meta": {
    "total": 10
  },
  "specialties": [
    {
      "category": "Allopathic & Osteopathic Physicians",
      "code": "207LC0200X",
      "id": "76a2744d4a",
      "name": "Anesthesiology",
      "sub_specialty": "Hospice and Palliative Medicine"
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "meta": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number",
          "description": "Number of entities returned"
        }
      },
      "description": "Meta-data"
    },
    "specialties": {
      "type": "array",
      "description": "Specialties"
    }
  }
}

Specialty Search
GET/specialties{?search_term,code,page,per_page}

Use this endpoint to find provider specialties. These specialties can be used to filter providers in the Provider Search.

URI Parameters
HideShow
search_term
string (optional) Example: Anesthesiology

Full or partial name of a specialty or subspecialty

code
string (optional) Example: 207LC0200X

CMS Healthcare Provider Taxonomy Code

page
number (optional) Example: 1

Page of paginated response

per_page
number (optional) Example: 1

Responses per page


ZipCounties

ZipCounties

GET /zip_counties?zip_prefix=1002
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "counties": [
    {
      "fips_code": "33025",
      "id": 1,
      "name": "Bergen County",
      "state_code": "NJ",
      "state_id": 123,
      "state_live": true,
      "state_live_for_business": false
    }
  ],
  "states": [
    {
      "code": "NY",
      "fips_number": "36",
      "id": 37,
      "last_date_for_individual": "2019-12-31",
      "last_date_for_shop": "2019-12-31",
      "live_for_business": true,
      "live_for_consumers": true,
      "name": "New York"
    }
  ],
  "zip_codes": [
    {
      "code": "11385",
      "id": 1
    }
  ],
  "zip_counties": [
    {
      "county_id": 5,
      "id": 1,
      "zip_code_id": 4
    }
  ]
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "counties": {
      "type": "array",
      "description": "Counties that exist in the provided zip prefix."
    },
    "states": {
      "type": "array",
      "description": "States that exist in the provided zip prefix."
    },
    "zip_codes": {
      "type": "array",
      "description": "ZipCodes that exist in the provided zip prefix."
    },
    "zip_counties": {
      "type": "array",
      "description": "ZipCounties that exist in the provided zip prefix."
    }
  }
}

Search for Zip Counties
GET/zip_counties{?zip_prefix}

Our Plan endpoints require a zip code and a fips (county) code. This is because plan pricing requires both of these elements. Users are unlikely to know their fips code, so we provide this endpoint to look up a ZipCounty by zip code and return both the selected zip and fips codes.

URI Parameters
HideShow
zip_prefix
string (required) Example: 1002

Partial five-digit Zip


ZipCounties

GET /zip_counties/12345
Requestsexample 1
Headers
Content-Type: application/json
Vericred-Api-Key: api-doc-key
Responses200
Headers
Content-Type: application/json
Body
{
  "counties": [
    {
      "fips_code": "33025",
      "id": 1,
      "name": "Bergen County",
      "state_code": "NJ",
      "state_id": 123,
      "state_live": true,
      "state_live_for_business": false
    }
  ],
  "states": [
    {
      "code": "NY",
      "fips_number": "36",
      "id": 37,
      "last_date_for_individual": "2019-12-31",
      "last_date_for_shop": "2019-12-31",
      "live_for_business": true,
      "live_for_consumers": true,
      "name": "New York"
    }
  ],
  "zip_codes": [
    {
      "code": "11385",
      "id": 1
    }
  ],
  "zip_county": {
    "county_id": 5,
    "id": 1,
    "zip_code_id": 4
  }
}
Schema
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "counties": {
      "type": "array",
      "description": "Counties that exist in the provided zip prefix."
    },
    "states": {
      "type": "array",
      "description": "States that exist in the provided zip prefix."
    },
    "zip_codes": {
      "type": "array",
      "description": "ZipCodes that exist in the provided zip prefix."
    },
    "zip_county": {
      "type": "object",
      "properties": {
        "county_id": {
          "type": "number",
          "description": "ID of the parent County in Vericred's API"
        },
        "id": {
          "type": "number",
          "description": "Primary key"
        },
        "zip_code_id": {
          "type": "number",
          "description": "ID of the parent Zip Code in Vericred's API"
        }
      },
      "description": "ZipCounty data"
    }
  }
}

Show an individual ZipCounty
GET/zip_counties/{id}

Our Plan endpoints require a zip code and a fips (county) code. This is because plan pricing requires both of these elements. Users are unlikely to know their fips code, so we provide this endpoint to returns the details for a ZipCounty by zip code and return both the selected zip and fips codes.

URI Parameters
HideShow
id
number (required) Example: 12345

Unique ID for ZipCounty


Bulk Plan and Rate Data

Vericred’s bulk plan data allows you to bring full sets of plan data into your database. The flat files we provide allow you to calculate availability and pricing for any plan as well as view the details of the plan.

Location

Bulk plan data is sold by market (individual or small group), state, and time period. The time period for individual plans is 1 year and the time period for small group plans is 1 quarter.

Vericred will provide you a key and secret for AWS S3, where the files are stored.

s3://vericred-emr-workers/production/plans/USERNAME/ADAPTER/individual/STATE/YEAR/*.json

s3://vericred-emr-workers/production/plans/USERNAME/ADAPTER/small_group/STATE/YEAR/QUARTER/*.json

e.g. s3://vericred-emr-workers/production/plans/vericred_customer/csv/small_group/NY/2017/Q4/*.json

Your USERNAME will be provided when we provision your key

Adapters

We generate files as single lines of JSON and as CSV. Certain customers also have a custom ETL, in which case their ETL name will be the adapter name.

Fields and Relationships

Whenever possible we use globally unique keys as ids in our export format. For example, a county_id is actually its fips_code. A state_id is actually the state_code (e.g. NY). And a zip_code_id is the zip code itself. When the field is a primary key for the resource in the file it is called id and when it is a foreign key to another resource, it is called RESOURCE_NAME_id (e.g. in the counties.csv file the id is the fips_code, while in the plan_counties.csv file the foreign key to counties is called county_id.

Handling Deletions of Plans

When plans are deleted, they and their pricings, are removed from the files that are exported nightly. To help manage the deletion process, we publish a list of deleted plans for each year. The list can be found at s3://vericred-emr-workers/production/plans/deleted_plans/YEAR_deleted_plans.csv. The list is for all states and includes just the id of the Plan, year, and datetime at which the plan was deleted.

Bulk Plans

Major Medical Plans are available in bulk format. The file generated contains the same Benefits Fields in the same format as is returned from the API. The relevant file is updated as changes are made to the underlying data set and is named plans.{csv,json}.

Note that Dental and Vision Plams are not available in bulk.

Bulk Rates

Major Medical Rates are available in bulk format. The file generated contains the Sheet Rates for each Plan in each Rating Area over a period. The period covered in a given file set will either be a Quarter (for Small Group) or a Year (for Individual). However, the Rates contained in the file may be active for all or part of the period, as designated by their effective_date and expiration_date

There is one Rate for each age (0-65) and one Rate for tobacco users for each age (0-65). A given Plan often has many Rates for a given period because it may be available in many Rating Areas

Note that Dental and Vision Plams are not available in bulk.

Bulk Service Areas

We denote Service Areas for each Carrier in two files: service_areas.{csv,json}, which contains meta-data about the Service Area like its name, and service_area_zip_counties.{csv,json}, which contains the actual definition of the Service Area. Each record in the plans.{csv,json} file has a service_area_id that corresponds to a record in the service_areas.{csv,json} file.

Counties

GET /s3-prefix/counties.{csv,json}

Counties
GET/s3-prefix/counties.{csv,json}

The counties file is a list of the counties in the given state.

{
  "id": "09001",
  "name": "Fairfield County",
  "state_id": "CT"
}
Field Type Description
id String Fips code for the County
name String Human-readable name for the County
state_id String Foreign key to the state – the state code

Issuers

GET /s3-prefix/issuers.{csv,json}

Issuers
GET/s3-prefix/issuers.{csv,json}

All valid issuers for the given state

{
  "id": "73836",
  "name": "Moda Health",
  "state_id": "AK"
}
Field Type Description
id String Hios Issuer ID for this Issuer
name String Name of the Issuer
state_id String Foreign key to the state – the state code

PlanCounties

GET /s3-prefix/plan_counties.{csv,json}

PlanCounties
GET/s3-prefix/plan_counties.{csv,json}

Relationships between plans and counties. These define “service areas” or areas in which a given plan is offered. Each plan in the plans file will have one or more rows in this file.

{
  "id": 1,
  "plan_id": "84982AK0080001",
  "county_id": "02016"
}
Field Type Description
id String Primary key for this resource (internal Vericred ID)
name String HIOS id foreign key for a plan
state_id String Fips code foreign key for a county

Plans

GET /s3-prefix/plans.{csv,json}

Plans
GET/s3-prefix/plans.{csv,json}

(See Benefits summary format above.)

{
  "abortion_rider": false,
  "actively_marketed": true,
  "actuarial_value": 61.7,
  "adult_dental": false,
  "age29_rider": false,
  "ambulance": "In-Network: $0 after deductible / Out-of-Network: $0 after deductible",
  "benefits_summary_url": "https://vericred.com/wp-content/uploads/2016/09/Vericred_final-copy.pdf",
  "buy_link": null,
  "carrier_disclaimers": "Employees must work at least 30 hours per week to qualify.",
  "carrier_name": "Sample Insurance",
  "child_dental": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "child_eye_exam": "In-Network: $0 / Out-of-Network: 20% after deductible | limit: 1 exam(s) per year",
  "child_eyewear": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible | limit: 1 item(s) per year",
  "chiropractic_services": true,
  "coinsurance": 0,
  "covered_ages": "allows adult and child-only",
  "customer_service_phone_number": null,
  "diagnostic_test": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "display_name": "Sample Bronze Plan",
  "dp_rider": false,
  "drug_formulary_url": "https://vericred.com/wp-content/uploads/2016/09/Vericred_final-copy.pdf",
  "durable_medical_equipment": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "effective_date": "2019-01-01",
  "embedded_deductible": "embedded",
  "emergency_room": "In-Network: $0 after deductible / Out-of-Network: $0 after deductible",
  "essential_health_benefits_percentage": 100,
  "expiration_date": "2019-12-31",
  "family_drug_deductible": "In-Network: $550 per person / Out-of-Network: $1,650 per person",
  "family_drug_moop": "In-Network: $550 per person / Out-of-Network: $1,650 per person",
  "family_medical_deductible": "In-Network: $13,100 / Out-of-Network: $39,300",
  "family_medical_moop": "In-Network: $13,100 / Out-of-Network: $47,400",
  "formulary_name": "AultCare MarketPlace HIX OH",
  "fp_rider": false,
  "gated": false,
  "generic_drugs": "In-Network: $0 after deductible / Out-of-Network: $0 after deductible",
  "habilitation_services": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "hios_issuer_id": 12345,
  "home_health_care": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible | limit: 100 visit(s) per year",
  "hospice_service": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "hsa_eligible": true,
  "id": "12345OH0090062",
  "imaging": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "imaging_center": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "imaging_physician": "In-Network: $10 plus 20% after deductible / Out-of-Network: 20% after deductible",
  "individual_drug_deductible": "In-Network: $550 / Out-of-Network: $1,650",
  "individual_drug_moop": "In-Network: $550 / Out-of-Network: $1,650",
  "individual_medical_deductible": "In-Network: $6,550 / Out-of-Network: $19,650",
  "individual_medical_moop": "In-Network: $6,550 / Out-of-Network: $23,700",
  "infertility_rider": true,
  "inpatient_birth": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "inpatient_birth_physician": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "inpatient_facility": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "inpatient_mental_health": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "inpatient_physician": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "inpatient_substance": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "issuer_plan_code": "",
  "key_benefits_complete": true,
  "lab_test": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "level": "bronze",
  "logo_url": "https://vericred.com/wp-content/uploads/2016/09/Vericred_final-copy.pdf",
  "mail_order_rx": 1,
  "name": "Sample Bronze Plan",
  "network_name": "PPO",
  "network_size": 1000,
  "non_preferred_brand_drugs": "In-Network: $0 after deductible / Out-of-Network: $0 after deductible",
  "nonpreferred_generic_drug_share": "In-Network: Not Applicable / Out-of-Network: Not Applicable",
  "nonpreferred_specialty_drug_share": "In-Network: Not Applicable / Out-of-Network: Not Applicable",
  "off_market": true,
  "on_market": true,
  "out_of_network_coverage": true,
  "outpatient_ambulatory_care_center": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "outpatient_facility": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "outpatient_mental_health": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "outpatient_physician": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "outpatient_substance": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "package_codes": "",
  "plan_ancestry": [
    {
      "id": "12345OH0090062",
      "year": "2018"
    }
  ],
  "plan_calendar": "plan_year",
  "plan_coinsurance": "In-Network: 0% / Out-of-Network: 0%",
  "plan_market": "both_markets",
  "plan_type": "PPO",
  "postnatal_care": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "preferred_brand_drugs": "In-Network: $0 after deductible / Out-of-Network: $0 after deductible",
  "prenatal_care": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "prenatal_postnatal_care": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "preventative_care": "In-Network: $0 / Out-of-Network: 20% after deductible",
  "primary_care_physician": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "rehabilitation_services": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible | limit: 40 visit(s) per year",
  "sbc_name": "Bronze 6550",
  "service_area_id": "12345-2019-OHS002",
  "skilled_nursing": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible | limit: 90 day(s) per year",
  "skilled_nursing_facility_365": "unknown",
  "source": "carrier",
  "specialist": "In-Network: $0 after deductible / Out-of-Network: 20% after deductible",
  "specialty_drugs": "In-Network: Not Applicable / Out-of-Network: Not Applicable",
  "telemedicine": true,
  "type": "ACAPlan2018",
  "updated_at": "2019-05-21",
  "urgent_care": "In-Network: $0 after deductible / Out-of-Network: $0 after deductible"
}

Note: All cost share values are from the perspective of the patient.

Field Type Examples Description
abortion_rider Boolean true, false Does the plan provide a degree of coverage for abortions when there is no public funding?
actuarial_value Decimal 0.0 to 100.0 (New in 2018) The total average cost for covered benefits that a plan will cover.
adult_dental Boolean true, false Does this plan offer adult dental coverage?
age29_rider Boolean true, false True if dependents up to age 29 are allowed
ambulance Benefit Description of the benefit for ambulance services - this is called “Emergency medical transportion” on an SBC
benefits_summary_url URL Link to Vericred’s hosted version of the Plan’s SBC
buy_link URL Link to the appropriate government marketplace where the user can buy this plan
carrier_disclaimers String Any disclaimers received from the carrier.
carrier_name String Name of Carrier who offers this Plan
child_dental Benefit Description of the benefit for child dental services - this is called “Dental check-up” on an SBC
child_eye_exam Benefit Description of the benefit for child eye exam - this is called “Eye exam” on an SBC
child_eyewear Benefit Description of the benefit for child eyewear - this is called “Glasses” on an SBC
chiropractic_services Boolean true, false Does the plan provide a degree of coverage for chiropractic services?
customer_service_phone_number String The customer service phone number for the Carrier where available
coinsurance Decimal 0.0 to 100.0 Percentage, between 0.0 and 100.0. The standard cost share for substantially all benefits
diagnostic_test Benefit Description of the benefit for diagnostic tests - this is called “Diagnostic test (x-ray, blood work)” on an SBC
dp_rider Boolean true, false True if plan does not cover domestic partnerships
drug_formulary_url URL URL for details on the drug formulary where available
durable_medical_equipment Benefit Description of the benefit for durable medical equipment - this is called “Durable medical equipment” on an SBC
effective_date String 2019-01-01 The first date for which this Plan is valid
embedded_deductible Enumerated embedded, non_embedded, or unknown Insurance starts paying once an individual meets their deductible (embedded) versus paying once the family meets its deductible (non-embedded).
emergency_room Benefit Description of the benefit for emergency room visits - this is called “Emergency room services” on an SBC
expiration_date String 2019-12-31 The last date for which this Plan is valid
family_drug_deductible Benefit Details on the drug deductible for a family - if it is included in the medical deductible, that is noted here
family_drug_moop Benefit Details on the drug maximum out-of-pocket for a family - if it is included in the medical maximum-out-of-pocket, that is noted here
family_medical_deductible Benefit Details on the medical deductible for a family
family_medical_moop Benefit Details on the medical maximum-out-of-pocket for a family
formulary_name String Human-readable name of the Plan’s Formulary
fp_rider Boolean true, false True if plan does not cover family planning
gated Boolean true, false Gated plans require primary care physician referral while non-gated plans do not. HMOs and POS plans are gated by default, while EPOs and PPOs are typically non-gated.
generic_drugs Benefit Description of the benefit for generic drugs - this is called “Generic drugs” on an SBC
habilitation_services Benefit Description of the benefit for habilitation services - this is called “Habilitation services” on an SBC
hios_issuer_id String HIOS issuer ID for the Carrier who offers this plan - foreign key to Issuers
home_health_care Benefit Description of the benefit for home health care - this is called “Home health care” on an SBC
hospice_service Benefit Description of the benefit for hospice service - this is called “Hospice service” on an SBC
id String HIOS ID for the Plan
imaging Benefit Description of the benefit for imaging - this is called “Imaging (CT/PET scans, MRIs)” on an SBC
imaging_center Benefit Description of the benefit for imaging performed in a hospital or other health center
imaging_physician Benefit Description of the benefit for imaging performed at the physician
individual_drug_deductible Benefit Details on the drug deductible for an individual - if it is included in the medical deductible, that is noted here
individual_drug_moop Benefit Details on the drug maximum out-of-pocket for an individual - if it is included in the medical maximum-out-of-pocket, that is noted here
individual_medical_deductible Benefit Details on the medical deductible for an individual
individual_medical_moop Benefit Details on the medical maximum-out-of-pocket for an individual
infertility_rider Boolean true, false Does the plan provide a degree of coverage for infertility care?
inpatient_birth Benefit Description of the benefit for inpatient birth - this is called “Delivery and all inpatient services” on an SBC
inpatient_birth_physician Benefit Description of the benefit for inpatient birth physician - this is called “Delivery and all inpatient services” on an SBC
inpatient_facility Benefit Description of the benefit for inpatient facility fees - this is called “Facility fee (e.g., ambulatory surgery center)” under “If you have a hospital stay” on an SBC
inpatient_mental_health Benefit Description of the benefit for inpatient mental health - this is called “Mental/Behavioral health inpatient services” on an SBC
inpatient_physician Benefit Description of the benefit for inpatient physician fees - this is called “Physician/surgeon fees” under “If you have a hospital stay” on an SBC
inpatient_substance Benefit Description of the benefit for inpatient substance use treatment - this is called “Substance use disorder inpatient services” on an SBC
issuer_plan_code String Plan code provided by the issuer
key_benefits_complete Boolean true, false Indicates whether the plan has meaningful descriptions for these benefits: individual_medical_deductible, family_medical_deductible, individual_medical_moop, family_medical_moop, primary_care_physician.
lab_test Benefit (New in 2018) Description of the benefit for lab tests
level String catastrophic, bronze, expanded_bronze, silver, gold, platinum Metal level of the Plan
logo_url URL Link to Vericred’s copy of the Carrier’s logo
mail_order_rx Decimal 1.5 Multiple of standard Rx cost share tiers for prescriptions filled through mail order. 1.5 would indicate mail-order prescriptions would be covered at 150% the normal rate.
name String Marketing name of the Plan
network_size Number Size of the network for this Plan
non_preferred_brand_drugs Benefit Description of the benefit for non-preferred brand drugs - this is called “Category 2 Formulary Brand drugs” on an SBC
off_market Boolean true, false Is this Plan available off of the public marketplace?
on_market Boolean true, false Is this Plan available on the public marketplace?
out_of_network_coverage Boolean true, false Does this Plan offer out-of-network benefits?
outpatient_ambulatory_care_center Benefit (New in 2018) Description of the benefit for outpatient ambulatory care
outpatient_facility Benefit Description of the benefit for outpatient facility fees - this is called “Facility fee (e.g., ambulatory surgery center)” under “If you have outpatient surgery” on an SBC
outpatient_mental_health Benefit Description of the benefit for outpatient mental health - this is called “Mental/Behavioral health outpatient services” on an SBC
outpatient_physician Benefit Description of the benefit for outpatientt physician fees - this is called “Physician/surgeon fees” under “If you have outpatient surgery” on an SBC
outpatient_substance Benefit Description of the benefit for outpatient substance use treatment - this is called “Substance use disorder outpatient services” on an SBC
package_codes String NY-CORE-1|NY-CORE-2 Pipe-delimited list of specific plan groups that are sold by certain carriers.
plan_ancestry Object The plan identifiers and years indicating the previous plans that this plan replaces.
plan_calendar Enumerated plan_year, calendar_year, or unknown (New in 2018) Describes whether or not accumulations of cost sharing towards deductibles and MOOPs resets with the calendar year or the plan year.
plan_coinsurance Benefit Description of the standard cost share for substantially all benefits.
plan_market Enumerated individual, small_group What markets is this plan available for (individual, small_group or both_markets)
plan_type String Is this Plan an HMO, PPO, etc
preferred_brand_drugs Benefit Description of the benefit for preferred brand drugs - this is called “Category 1 Formulary Brand drugs” on an SBC
prenatal_care Benefit (New in 2018) Description of the benefit for prenatal care - this is called “Prenatal care” on an SBC
postnatal_care Benefit (New in 2018) Description of the benefit for postnatal care - this is called “Postnatal care” on an SBC
prenatal_postnatal_care Benefit Description of the benefit for prenatal and postnatal care combined - this is called “Prenatal and postnatal care” on an SBC
preventative_care Benefit Description of the benefit for preventative care - this is called “Preventive care/ screening/immunization” on an SBC
primary_care_physician Benefit Description of the benefit for the customer’s PCP - this is called “Primary care visit to treat an injury or illness” on an SBC
rehabilitation_services Benefit Description of the benefit for rehabilitation services - this is called “Rehabilitation services” on an SBC
skilled_nursing Benefit Description of the benefit for skilled nursing services - this is called “Skilled nursing care” on an SBC
skilled_nursing_facility_365 Enumerated unlimited or unknown (New in 2018) Value showing the variations for unlimited skilled nursing facility days. (Applies to New York plans only)
specialist Benefit Description of the benefit for seeing a specialist - this is called “Specialist visit” on an SBC
specialty_drugs Benefit Description of the benefit for specialty drugs - this is called “Specialty drugs” on an SBC
telemedicine Boolean Does the plan provide a degree of coverage for telemedicine services?
updated_at String 2019-12-31 The last date for which this Plan was updated.
urgent_care Benefit Description of the benefit for urgent care - this is called “Urgent care” on an SBC

Pricings

GET /s3-prefix/pricings.{csv,json}

Pricings
GET/s3-prefix/pricings.{csv,json}

Pricing data for each Rating Area/Age/Plan combination. Vericred supplies one row per combination in age-banded states (i.e. ages 0-64 for each Plan in each relevant Rating Area). In community rated states, Vericred supplies one row per Plan/Rating Area combination with all of the relevant community pricing. The default age for this pricing is 21.

{
    "rate": {
        "age_0": "204.94",
        "age_0_tobacco": "204.94",
        "age_1": "204.94",
        "age_1_tobacco": "204.94",
        "age_2": "204.94",
        "age_2_tobacco": "204.94",
        "age_3": "204.94",
        "age_3_tobacco": "204.94",
        "age_4": "204.94",
        "age_4_tobacco": "204.94",
        "age_5": "204.94",
        "age_5_tobacco": "204.94",
        "age_6": "204.94",
        "age_6_tobacco": "204.94",
        "age_7": "204.94",
        "age_7_tobacco": "204.94",
        "age_8": "204.94",
        "age_8_tobacco": "204.94",
        "age_9": "204.94",
        "age_9_tobacco": "204.94",
        "age_10": "204.94",
        "age_10_tobacco": "204.94",
        "age_11": "204.94",
        "age_11_tobacco": "204.94",
        "age_12": "204.94",
        "age_12_tobacco": "204.94",
        "age_13": "204.94",
        "age_13_tobacco": "204.94",
        "age_14": "204.94",
        "age_14_tobacco": "204.94",
        "age_15": "223.16",
        "age_15_tobacco": "223.16",
        "age_16": "230.12",
        "age_16_tobacco": "230.12",
        "age_17": "237.09",
        "age_17_tobacco": "237.09",
        "age_18": "244.59",
        "age_18_tobacco": "244.59",
        "age_19": "252.09",
        "age_19_tobacco": "252.09",
        "age_20": "259.86",
        "age_20_tobacco": "259.86",
        "age_21": "267.89",
        "age_21_tobacco": "267.89",
        "age_22": "267.89",
        "age_22_tobacco": "267.89",
        "age_23": "267.89",
        "age_23_tobacco": "267.89",
        "age_24": "267.89",
        "age_24_tobacco": "267.89",
        "age_25": "268.97",
        "age_25_tobacco": "268.97",
        "age_26": "274.32",
        "age_26_tobacco": "274.32",
        "age_27": "280.75",
        "age_27_tobacco": "280.75",
        "age_28": "291.2",
        "age_28_tobacco": "291.2",
        "age_29": "299.77",
        "age_29_tobacco": "299.77",
        "age_30": "304.06",
        "age_30_tobacco": "304.06",
        "age_31": "310.49",
        "age_31_tobacco": "310.49",
        "age_32": "316.92",
        "age_32_tobacco": "316.92",
        "age_33": "320.94",
        "age_33_tobacco": "320.94",
        "age_34": "325.22",
        "age_34_tobacco": "325.22",
        "age_35": "327.37",
        "age_35_tobacco": "327.37",
        "age_36": "329.51",
        "age_36_tobacco": "329.51",
        "age_37": "331.65",
        "age_37_tobacco": "331.65",
        "age_38": "333.8",
        "age_38_tobacco": "333.8",
        "age_39": "338.08",
        "age_39_tobacco": "338.08",
        "age_40": "342.37",
        "age_40_tobacco": "342.37",
        "age_41": "348.8",
        "age_41_tobacco": "348.8",
        "age_42": "354.96",
        "age_42_tobacco": "354.96",
        "age_43": "363.53",
        "age_43_tobacco": "363.53",
        "age_44": "374.25",
        "age_44_tobacco": "374.25",
        "age_45": "386.84",
        "age_45_tobacco": "386.84",
        "age_46": "401.84",
        "age_46_tobacco": "401.84",
        "age_47": "418.72",
        "age_47_tobacco": "418.72",
        "age_48": "438.01",
        "age_48_tobacco": "438.01",
        "age_49": "457.03",
        "age_49_tobacco": "457.03",
        "age_50": "478.46",
        "age_50_tobacco": "478.46",
        "age_51": "499.62",
        "age_51_tobacco": "499.62",
        "age_52": "522.93",
        "age_52_tobacco": "522.93",
        "age_53": "546.5",
        "age_53_tobacco": "546.5",
        "age_54": "571.95",
        "age_54_tobacco": "571.95",
        "age_55": "597.4",
        "age_55_tobacco": "597.4",
        "age_56": "625.0",
        "age_56_tobacco": "625.0",
        "age_57": "652.86",
        "age_57_tobacco": "652.86",
        "age_58": "682.59",
        "age_58_tobacco": "682.59",
        "age_59": "697.33",
        "age_59_tobacco": "697.33",
        "age_60": "727.06",
        "age_60_tobacco": "727.06",
        "age_61": "752.78",
        "age_61_tobacco": "752.78",
        "age_62": "769.66",
        "age_62_tobacco": "769.66",
        "age_63": "790.82",
        "age_63_tobacco": "790.82",
        "age_64": "803.68",
        "age_64_tobacco": "803.68",
        "age_65": "803.68",
        "age_65_tobacco": "803.68",
        "single": null,
        "single_and_children": null,
        "single_and_spouse": null,
        "child_only": null,
        "family": null,
        "effective_date": "2019-10-01",
        "expiration_date": "2019-12-31",
        "plan_id": "12345ME1231231",
        "source": "carrier"
    }
}
Field Type Description
age_0…65 (tobacco) String The rate for the given age. If tobacco is appended to the name, then the rate for smokers of tobacco.
effective_date String Start date on which the pricing is applicable
expiration_date String End date on which the pricing is applicable
plan_id String Foreign key HIOS ID for the Plan
premium_child_only Number Premium for one or more children - only valid in community-rated states, null everywhere else
premium_family Number Premium for two adults and one or more children - only valid in community-rated states, null everywhere else
premium_single Number Premium for a single applicant of the relevant age
premium_single_and_children Number Premium for one adult and one or more children - only valid in community-rated states, null everywhere else
premium_single_and_spouse Number Premium for two adults - only valid in community-rated states, null everywhere else
premium_single_smoker Number Premium for a single applicant of the relevant age who uses tobacco
rating_area_id String Foreign key to RatingArea
updated_at String The last date for which the rate set was updated.

RatingAreas

GET /s3-prefix/rating_areas.{csv,json}

RatingAreas
GET/s3-prefix/rating_areas.{csv,json}

All relevant RatingAreas for the given State

{
  "id":"TX26",
  "state_id":"TX"
}
Field Type Description
id String Unique ID of the RatingArea
state_id String Foreign key to State - the State code

ServiceAreas

GET /s3-prefix/service_areas.{csv,json}

ServiceAreas
GET/s3-prefix/service_areas.{csv,json}

All relevant ServiceAreas for the given State

{
  "id":"21032-2017-COS003",
  "issuer_id":"21032",
  "name":"Northern Colorado"
}
Field Type Description
id String Unique ID of the ServiceArea
issuer_id String Foreign key to Issuer
name String Rating Area Name

ZipCounties

GET /s3-prefix/zip_counties.{csv,json}

ZipCounties
GET/s3-prefix/zip_counties.{csv,json}

ZipCode-County combinations are the most granular way to define RatingAreas because some RatingAreas are defined by ZipCode and some by County. This file lists every combination of ZipCode and County in the relevant state and which RatingArea it is assigned to. From a given ZipCode/County, you can find a RatingArea’s ID. From that, you can find Pricing for all Plans in that RatingArea

{
  "id": 255730,
  "rating_area_id": "TX26",
  "county_id": "48121",
  "zip_code_id": "75034"
}
Field Type Description
id Integer Vericred’s internal ID
rating_area_id String Foreign key to RatingArea
county_id String Foreign key to County - the fips code
zip_code_id String Zip Code

Generated by aglio on 17 Sep 2019