Healthcare.gov API

Beginner's Pick Health / No Auth Required Beginner HTTPS
Free to Use
69 C
Measured Score 0 50 100 Speed 24/30 Consistency 17/20 Security 20/20 Browser access 0/15 Transparency 8/15 TESTED 2026-08-10

Overview

The Healthcare.gov API provides access to educational content about the US Health Insurance Marketplace, including articles, glossary terms, and plan information in JSON format. No API key is required, and the data is maintained by the US federal government. It is a good starting point for developers building health insurance information tools or educational resources for Americans.

Beginner Tip

Append .json to any Healthcare.gov page URL to retrieve that page's content as structured JSON — for example, https://www.healthcare.gov/glossary/deductible.json returns the full article as machine-readable data.

Measurement Record

What actually happened when we called this API from our own infrastructure. Every value below was recorded by the request, not copied from the provider's documentation.

Request
GET https://www.healthcare.gov/api/glossary.json
Result
HTTP 200 · application/json · 117,301 bytes · compressed
Response time
47 ms (median of 3) · fastest 44 ms
Transport
TLSv1.3 · TLS_AES_256_GCM_SHA384 · certificate issued by DigiCert Inc
Browser CORS
No Access-Control-Allow-Origin header — call it from a server, not the browser
Recorded
2026-08-10

Fields Returned

Top-level fields present in the response we captured, with the type and value we actually received.

Field Type Value received
glossary array [1 item]

Captured Response

Captured from a real request to https://www.healthcare.gov/api/glossary.json on 2026-08-10. Long arrays and nested objects are truncated to keep the shape readable.

JSON Response · Captured
{
  "glossary": [
    {
      "date": "2022-04-22 00:00:00 +0000",
      "url": "/glossary/affordability-exemption",
      "content": "<p>An exemption that’s needed when applying for Catastrophic coverage for people 30 years or older whose coverage is unaffordable. Affordability exemptions a…",
      "tags": [
        "glossary"
      ],
      "title": "Affordability exemption",
      "categories": [
        "glossary"
      ],
      "lang": "en",
      "layout": "glossary-word"
    }
  ]
}

Field Reference

title Title of the article or glossary term.
content HTML-formatted body content of the article.
url Canonical URL of the content on Healthcare.gov.
categories List of category tags associated with the content.
lang Language code of the content (e.g., en for English, es for Spanish).

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://www.healthcare.gov/api/glossary.json";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

How This API Fails

We deliberately sent this API a broken request and recorded exactly what came back on 2026-08-10. Knowing the shape of an error before you hit it makes error handling much easier to write.

HTTP 404 Requesting a path that does not exist text/html

Returned an HTML error page rather than JSON — worth knowing if your client assumes every response can be parsed as JSON.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

404 Not Found for a page URL The page may have been moved or the URL slug does not match exactly.
Browse the Healthcare.gov sitemap or use the content index endpoint to discover valid content slugs.
Response is HTML instead of JSON Omitting the .json extension returns the human-readable webpage instead of the API response.
Always append .json to the URL and ensure you are not following a redirect to a non-JSON page.
Content is out of date Enrollment periods and plan details change annually; cached or old data may be inaccurate.
Always display the source URL and encourage users to verify details at healthcare.gov directly.

Measured Score Breakdown

Live HTTP request to the API endpoint

Speed 24/30
Consistency 17/20
Security 20/20
Browser access 0/15
Transparency 8/15
Endpoint Response Time 47ms

Fully tested on Aug 10, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS UNKNOWN
Category Health
Difficulty Beginner
Endpoint last called: 2026-08-10

Similar APIs

View All →