Skip to content

Get full plan details by ID

GET
/v1/health/plans/{plan_id}

Returns complete plan information including cost sharing tiers (in-network, out-of-network), SBC scenario data, external links, and coverage details. Requires Pro or Enterprise subscription.

plan_id
required
string

Plan variant ID (e.g. 21989AK0030001-01)

Example
21989AK0030001-01
year
integer
default: 2026 >= 2014 <= 2030

Plan year. Defaults to 2026. Available: 2026

Full plan details with cost sharing and SBC scenarios

Full plan details including cost sharing tiers, SBC scenarios, and external links

object
_links
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
collection

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
id
string
standard_component_id
string
name
string
issuer
string
state
string
metal_level
string
plan_type
string
service_area_id
string
hsa_eligible
boolean
national_network
boolean
deductible
object
individual_tier1
number
nullable
individual_tier2
number
nullable
family_tier1
number
nullable
family_tier2
number
nullable
individual_oon
number
nullable
family_oon
number
nullable
max_out_of_pocket
object
individual_tier1
number
nullable
individual_tier2
number
nullable
family_tier1
number
nullable
family_tier2
number
nullable
individual_oon
number
nullable
family_oon
number
nullable
combined_individual
number
nullable
combined_family
number
nullable
sbc_scenarios
object
having_baby
object
deductible
number
nullable
copayment
number
nullable
coinsurance
number
nullable
limit
number
nullable
having_diabetes
object
deductible
number
nullable
copayment
number
nullable
coinsurance
number
nullable
limit
number
nullable
external_links
object
benefits_summary
string format: uri
nullable
brochure
string format: uri
nullable
formulary
string format: uri
nullable
provider_directory
string format: uri
nullable
benefits
string format: uri
nullable
enrollment
string format: uri
nullable
coverage
object
child_only_offering
string
nullable
wellness_program
string
nullable
disease_management_programs
string
nullable
ehb_percent_total_premium
number
nullable
out_of_country
boolean
nullable
out_of_service_area
boolean
nullable
referral_required
boolean
nullable
specialist_referral_required
boolean
nullable
plan_year
integer
data_source
string
data_freshness
string
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)

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"
}
WWW-Authenticate
string

Bearer authentication challenge

Feature requires a higher-tier subscription

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

Resource not found

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

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