List insurance issuers by state

GET

/v1/health/issuers

• Production

Returns all insurance issuers offering individual market health plans in a state, with plan counts. Aggregated from plan data.

Authorizations

• bearerAuth

Parameters

Query Parameters

state

required

string

>= 2 characters <= 2 characters /^[A-Z]{2}$/

2-letter state code. All 51 jurisdictions (50 states + DC) are supported.

Example

FL

year

integer

default: 2026 >= 2014 <= 2030

Plan year. Defaults to 2026. Available: 2025, 2026

Responses

200

List of issuers in the specified state with plan counts

List of insurance issuers in a state with plan counts

object

_links

required

object

self

A HAL link object (draft-kelly-json-hal-11 §5)

object

href

required

Target URI or URI Template

string format: uri-reference

templated

True when href is an RFC 6570 URI Template

boolean

type

Media type hint for the target resource

string

title

Human-readable link title

string

state

required

2-letter state code

string

Example

FL

year

required

Plan year

integer

Example

2026

issuers

required

Insurance issuers in the state, ordered by name

Array<object>

object

issuer_id

required

5-digit HIOS issuer ID

string

Example

47163

name

required

Insurance company name

string

Example

Ambetter of Sunshine Health

plan_count

required

Number of plans offered by this issuer in the state

integer

Example

42

total

required

Total number of issuers in the state

integer

Example

8

data_source

required

Data origin

string

Allowed values: puf_data state_exchange

data_freshness

required

Data freshness label

string

Example

{
  "_links": {
    "self": {
      "href": "https://api.opelyx.com/v1/health/issuers?state=FL&year=2026",
      "type": "application/json"
    }
  },
  "state": "FL",
  "year": 2026,
  "issuers": [
    {
      "issuer_id": "47163",
      "name": "Ambetter of Sunshine Health",
      "plan_count": 42
    },
    {
      "issuer_id": "54172",
      "name": "Florida Blue",
      "plan_count": 38
    },
    {
      "issuer_id": "16842",
      "name": "Molina Healthcare of Florida",
      "plan_count": 24
    }
  ],
  "total": 8,
  "data_source": "puf_data",
  "data_freshness": "PY2026 CMS PUF (30 FFM) + state exchange data (21 SBM). All 50 states + DC covered"
}

Headers

X-Request-Id

string format: uuid

Unique request identifier for tracing

Link

string

RFC 8288 Web Linking (pagination and resource discovery)

ETag

string

Weak ETag for conditional request support (If-None-Match)

400

Invalid state or year parameter

RFC 9457 Problem Details for HTTP APIs (application/problem+json)

object

type

required

URI identifying the problem type. about:blank for standard HTTP status semantics.

string format: uri

title

required

Short human-readable summary of the problem type

string

status

required

HTTP status code

integer

detail

required

Human-readable explanation specific to this occurrence

string

instance

URI reference identifying the specific occurrence (request path)

string format: uri-reference

errors

Validation errors (extension member, present on 400 responses)

Array<object>

object

field

Dot-delimited path to the invalid field

string

message

Validation error message

string

required_tier

Minimum subscription tier required (extension member, present on 402 responses)

string

Allowed values: pro enterprise

upgrade

URL to upgrade subscription (extension member, present on 402/429 responses)

string format: uri

Example

{
  "type": "https://api.opelyx.com/problems/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Plan 99999XX0000000-00 not found.",
  "instance": "/v1/health/plans/99999XX0000000-00"
}

401

Missing or invalid API key

RFC 9457 Problem Details for HTTP APIs (application/problem+json)

object

type

required

URI identifying the problem type. about:blank for standard HTTP status semantics.

string format: uri

title

required

Short human-readable summary of the problem type

string

status

required

HTTP status code

integer

detail

required

Human-readable explanation specific to this occurrence

string

instance

URI reference identifying the specific occurrence (request path)

string format: uri-reference

errors

Validation errors (extension member, present on 400 responses)

Array<object>

object

field

Dot-delimited path to the invalid field

string

message

Validation error message

string

required_tier

Minimum subscription tier required (extension member, present on 402 responses)

string

Allowed values: pro enterprise

upgrade

URL to upgrade subscription (extension member, present on 402/429 responses)

string format: uri

Example

{
  "type": "https://api.opelyx.com/problems/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Plan 99999XX0000000-00 not found.",
  "instance": "/v1/health/plans/99999XX0000000-00"
}

Headers

WWW-Authenticate

string

Bearer authentication challenge

429

Rate limit exceeded

RFC 9457 Problem Details for HTTP APIs (application/problem+json)

object

type

required

URI identifying the problem type. about:blank for standard HTTP status semantics.

string format: uri

title

required

Short human-readable summary of the problem type

string

status

required

HTTP status code

integer

detail

required

Human-readable explanation specific to this occurrence

string

instance

URI reference identifying the specific occurrence (request path)

string format: uri-reference

errors

Validation errors (extension member, present on 400 responses)

Array<object>

object

field

Dot-delimited path to the invalid field

string

message

Validation error message

string

required_tier

Minimum subscription tier required (extension member, present on 402 responses)

string

Allowed values: pro enterprise

upgrade

URL to upgrade subscription (extension member, present on 402/429 responses)

string format: uri

Example

{
  "type": "https://api.opelyx.com/problems/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Plan 99999XX0000000-00 not found.",
  "instance": "/v1/health/plans/99999XX0000000-00"
}

Headers

Retry-After

integer

Seconds until the rate limit resets

RateLimit-Limit

integer

Maximum requests per day for this tier

RateLimit-Remaining

integer

Remaining requests today

RateLimit-Reset

integer

Unix timestamp when the limit resets (midnight UTC)