v1

latestOpenAPI 3.0.02026-07-231358118.3 KB
Quotes

Get health insurance plan quotes

Fetch health insurance plans based on location, household details, and filtering criteria

post/api/v1/quotes

Request body

zip_codestring required

ZIP code for the location

fip_codestring required

County code (FIPS) for the location

household_incomenumber

Annual household income. Only required if the client wants subsidy information included in the result.

statestring

State abbreviation

plan_yearinteger

Plan year

current_pageinteger

Current page number for pagination

per_pageinteger

Number of results per page (max 500)

dental_searchboolean

Whether to include dental plans in search

sort'premium_asc' | 'premium_desc' | 'deductible_asc' | 'deductible_desc' | 'moop_asc' | 'moop_desc'

Sort order for results

add_attributesboolean

When true, includes an attributes array on each plan with comparative rankings (good/bad/avg) across cost and feature categories.

utilization'low' | 'medium' | 'high'

Healthcare usage level for cost modeling. Affects attributes rankings. Only meaningful when add_attributes is true.

all_benefitsboolean

When true, returns the full SBC benefit list. Default returns a curated subset of commonly compared benefits.

all_detailsboolean

When true, includes cost_sharing_tiers with per-tier (in-network, in-network tier 2, out-of-network) deductible, MOOP, and coinsurance breakdowns.

off_exboolean

Return only off-exchange plans. Otherwise, will only return on-exchange plans.

include_non_enrollable_offexboolean

If true, includes off-exchange plans the are not enrollable on HealthSherpa.

networksstring[]

Filter by network types

metal_levelsstring[]

Filter by metal levels

issuer_hios_idsstring[]

Filter by specific issuer HIOS IDs

providersstring[]

Provider NPIs to include per-plan coverage data for

Response

Successfully retrieved plan quotes