Getting Started
Introduction
ACA enrollment requires separate integrations across the federal marketplace, state-based marketplaces, and off-exchange carriers. Quoting, enrollment, policy status, and payment operations vary by exchange type and carrier. HealthSherpa ONE exposes HealthSherpa’s carrier and marketplace connections through one API that CRMs, lead generators, and market analysis products can call.
HealthSherpa ONE is a REST API served from
https://api.one.healthsherpa.com. Endpoints map to resources under
/v1/, requests and responses use JSON, and callers authenticate with an
x-api-key header. The API follows conventional HTTP methods and status
codes.
GET /v1/ping, reference endpoints, and POST /v1/quotes are
available when your API key is active. POST /v1/enrollment-sessions,
/v1/enrollments, and /v1/policy-status/applications require
approval in the developer portal before use.
There is no separate public sandbox; your API key uses production rating and enrollment
infrastructure. Policy-status calls and agent_assisted enrollment-sessions
require a linked HealthSherpa Marketplace OAuth account in addition to the API key.
self_service enrollment-sessions use a configured deeplink agent ID and do not
consult OAuth. Policy status returns applications and carrier feed data for the linked
agent account only.
Supported features
The API currently supports:
ACA quoting
POST /v1/quotes returns personalized plan and premium results for on- or
off-exchange medical coverage, including issuer, pricing, plan details, document links,
and api_enrollable for direct enrollment eligibility at quote time.
Reference data
GET /v1/reference/counties, GET /v1/reference/issuers, and
GET /v1/reference/providers help you prepare quote and enrollment requests
with the right geography, issuer filters, and provider identifiers.
On-exchange enrollment sessions
POST /v1/enrollment-sessions returns HealthSherpa-hosted deeplinks for
agent-assisted or self-service browser flows. Approval is required before use.
Policy status
GET /v1/policy-status/applications lists on-exchange applications for the
OAuth-linked agent account. GET /v1/policy-status/applications/{confirmation_id}
returns carrier policy and payment status for one application. Send
exchange=on_exchange and plan_year on every request. Approval
and a linked Marketplace OAuth account are required before use.
This is an alpha release. Not every policy has status data yet, and coverage, accuracy, and completeness improve continuously as we work with more carriers.
The linked Marketplace account must include the policy_status_api OAuth scope.
If you linked before policy status was enabled, use Re-link account on the
API Access page; token refresh does not add new scopes to an existing link.
Off-exchange enrollment API
/v1/enrollments supports the full off-exchange application lifecycle for
approved partners, including create, read, update, submit, cancel, terminate, payment redirect,
and supporting documentation. Approval is required before use.
Compliance
HealthSherpa is an Enhanced Direct Enrollment (EDE) entity. On-exchange workflows—ACA marketplace quoting, enrollment sessions, and policy status readback—follow CMS marketplace rules where those capabilities are approved.
Off-exchange quoting and the /v1/enrollments direct enrollment API follow
carrier and off-exchange compliance requirements, separate from CMS marketplace EDE rules.
Quoting is available when your API key is active. Additional capabilities require portal approval under HealthSherpa’s exchange and carrier compliance review. See Onboarding for access requests.