HealthCare.gov

App · 5 actions

Read HealthCare.gov's official consumer content: define health insurance terms in English or Spanish, search and read its help articles, and get each state's guide to Medicaid, CHIP and the Marketplace. No account or API key required.

Actions

ActionWhat it does
Get articleGet one HealthCare.gov help article in full, as plain text, with its summary and links.
Get glossary termGet the full HealthCare.gov definition of one health insurance term, in English or Spanish, with its one-sentence summary.
Get state informationGet HealthCare.gov's guide to coverage in one U.S. state or territory: where to get consumer help, how to apply for Medicaid and CHIP, and which Marketplace to use, with the state's own links.
Search articlesSearch HealthCare.gov's help articles (enrolling, Medicaid, taxes, life changes...) by words in their title or text, with a short summary and link for each.
Search glossarySearch HealthCare.gov's glossary of health insurance terms (deductible, premium, coinsurance...) and get their definitions as plain text.

Get article

Get one HealthCare.gov help article in full, as plain text, with its summary and links. No API key required.

Inputs

ArticlearticletextRequired
The article's HealthCare.gov link or address, e.g. turning-26 (Search articles gives it as 'path').

Outputs

keywordstext
Search keywords HealthCare.gov gives the article.
linkslist
The links in the text.
pathtext
The article's address on HealthCare.gov, e.g. 'turning-26'.
summarytext
HealthCare.gov's one-sentence summary of the article.
texttext
The whole article as plain text, one paragraph or list item a line.
titletext
The article's title.
urltext
The article's page, to link to.
Example output
{
  "keywords": "job-based insurance dependent coverage to age 26 health insurance until age 26 under 26",
  "links": [
    {
      "text": "Learn more about coverage for people under 30.",
      "url": "https://www.healthcare.gov/young-adults/coverage"
    }
  ],
  "path": "turning-26",
  "summary": "Find out what you need to know about getting your own health coverage when you turn 26 and are no longer eligible to stay on your parent's health plan.",
  "text": "If you have health coverage under a parent\u2019s plan and are turning 26, you need to take action. If you don\u2019t, you may have no health coverage. Why bother with health insurance?\nLearn more about coverage for people under 30.",
  "title": "Getting your own health coverage when you turn 26",
  "url": "https://www.healthcare.gov/turning-26/"
}

Get glossary term

Get the full HealthCare.gov definition of one health insurance term, in English or Spanish, with its one-sentence summary. No API key required.

Inputs

TermtermtextRequired
The term (e.g. Premium, or Prima in Spanish) or its HealthCare.gov link.
Languagelanguagetext
English or Spanish. English by default.One of: en (English), es (Spanish). Default: en.

Outputs

datetext
When the definition was published, as YYYY-MM-DD.
definitiontext
The full definition as plain text, one paragraph or list item a line.
languagetext
'en' for English or 'es' for Spanish.
slugtext
The term's address on HealthCare.gov, e.g. 'premium'.
summarytext
The one-sentence definition, e.g. 'A monthly amount you pay for coverage whether you get services or not.'
titletext
The term, e.g. 'Premium' (or 'Prima' in Spanish).
urltext
The term's page, to link to.
Example output
{
  "date": "2022-05-19",
  "definition": "The amount you pay for your health insurance every month. In addition to your premium, you usually have to pay other costs for your health care, including a deductible, copayments, and coinsurance.",
  "language": "en",
  "slug": "premium",
  "summary": "A monthly amount you pay for coverage whether you get services or not.",
  "title": "Premium",
  "url": "https://www.healthcare.gov/glossary/premium/"
}

Get state information

Get HealthCare.gov's guide to coverage in one U.S. state or territory: where to get consumer help, how to apply for Medicaid and CHIP, and which Marketplace to use, with the state's own links. No API key required.

Inputs

StatestatetextRequired
The state or territory.One of: AL (Alabama), AK (Alaska), AS (American Samoa), AZ (Arizona), AR (Arkansas), CA (California), CO (Colorado), CT (Connecticut), DE (Delaware), DC (District of Columbia), and 46 more.

Outputs

countnumber
How many sections there are.
sectionslist
The guide's sections: consumer assistance, Medicaid, the Marketplace, SHOP and CHIP, with the state's own links.
slugtext
Its address on HealthCare.gov, e.g. 'california'.
statetext
The state or territory, e.g. 'California'.
titletext
The page title.
urltext
The state's page, to link to.
Example output
{
  "count": 2,
  "sections": [
    {
      "heading": "Medicaid in California",
      "links": [
        {
          "text": "contacting your state Medicaid agency",
          "url": "http://www.dhcs.ca.gov/Pages/default.aspx"
        }
      ],
      "text": "You can apply for Medicaid in California by contacting your state Medicaid agency."
    },
    {
      "heading": "Health Insurance Marketplace\u00ae in California",
      "links": [],
      "text": "If you live in California, you'll use the Covered California website to enroll in health coverage."
    }
  ],
  "slug": "california",
  "state": "California",
  "title": "California",
  "url": "https://www.healthcare.gov/california/"
}

Search articles

Search HealthCare.gov's help articles (enrolling, Medicaid, taxes, life changes...) by words in their title or text, with a short summary and link for each. No API key required.

Inputs

Search textquerytextRequired
Words to find. Articles with every word in the title come first.
Max resultslimitnumber
The most results to return, from 1 to 100.From 1 to 100. Default: 10.

Outputs

articleslist
The matching articles, best matches first.
countnumber
How many articles came back.
totalnumber
How many articles matched, before Max results.
Example output
{
  "articles": [
    {
      "path": "turning-26",
      "summary": "If you have health coverage under a parent\u2019s plan and are turning 26, you need to take action. If you don\u2019t, you may have no health coverage.",
      "title": "Getting your own health coverage when you turn 26",
      "url": "https://www.healthcare.gov/turning-26/"
    }
  ],
  "count": 1,
  "total": 1
}

Search glossary

Search HealthCare.gov's glossary of health insurance terms (deductible, premium, coinsurance...) and get their definitions as plain text. Leave the search empty to list every term, A to Z. No API key required.

Inputs

Search textquerytext
Words to find in a term or its definition. Terms whose name matches come first.
Max resultslimitnumber
The most results to return, from 1 to 100.From 1 to 100. Default: 10.

Outputs

countnumber
How many terms came back.
termslist
The matching terms, best matches first.
totalnumber
How many terms matched, before Max results.
Example output
{
  "count": 1,
  "terms": [
    {
      "date": "2013-06-05",
      "definition": "How much you\u2019ll pay for certain covered services and items each year before your plan starts to pay (except free preventive services).",
      "language": "en",
      "slug": "deductible",
      "title": "Deductible",
      "url": "https://www.healthcare.gov/glossary/deductible/"
    }
  ],
  "total": 1
}

On this page