Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Centers for Medicare and Medicaid Services Geography API

Geographic data, including information on states, counties, and zipcodes.

Centers for Medicare and Medicaid Services Geography API is one of 16 APIs that Centers for Medicare and Medicaid Services publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Geography. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and a GitHub repository.

This API exposes 7 operations across 7 paths, and defines 9 schemas. It is described by OpenAPI 2.0, at version 1.

Requests are made against the base URL https://marketplace.api.healthcare.gov/api/v1.

7 operations 7 paths 9 schemas 7 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1
Base URL
https://marketplace.api.healthcare.gov/api/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Centers for Medicare and Medicaid Services Geography API declares 1 security scheme for authenticating requests. An API key is passed in the query as apikey (API Key). By default, every request must be authenticated.

  • API Key — Your API key should be included as a query parameter with the request. You can [fill out this form](https://cms.gov1.qualtrics.com/jfe/form/SV4N2GHCJfNuX7n8x)…

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 7 GET. Each is listed below with its method, path, parameters, and response codes.

Geography 7

Geographic data, including information on states, counties, and zipcodes.

GET
/counties/by/zip/{zipcode}
Find counties matching ZIP Code (5 digits or prefix thereof). This method is suitable for use in typeahead UI completions.
3 params → 200
GET
/counties/{fips}
Get information about a county by its FIPS code.
3 params → 200
GET
/states
List all U.S. states.
2 params → 200
GET
/states/{abbrev}
Get a U.S. state from its 2-letter USPS abbreviation.
3 params → 200
GET
/states/{abbrev}/medicaid
Get Medicaid data for a U.S. state for a specific fiscal year.
4 params → 200
GET
/states/{abbrev}/poverty-guidelines
Get U.S. federal poverty guidelines for the provided state.
3 params → 200
GET
/rate-areas
Get market year rate area for a given zip/fips/state.
6 params → 200

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are State (12 properties), StateMedicaid (12 properties), ZIPCounty (4 properties), County (3 properties). Each schema is shown below with its type and property counts.

RateArea
object
2 properties
PovertyGuideline
object
2 properties
State
object
12 properties
Guideline
object
2 properties
StateMedicaid
object
12 properties
ZIPCounty
object
4 properties
MarketplaceModelEnum
string
County
object
3 properties
LowIncomeChild
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cms-geography-api-openapi.yml Raw ↑

Other APIs Centers for Medicare and Medicaid Services publishes across the network.

CMS Beneficiary Claims Data API (BCDA)
CMS AB2D API (Claims Data to Part D Sponsors)
CMS Data at the Point of Care (DPC) API
CMS Finder API
CMS Quality Payment Program (QPP) Submissions API
Centers for Medicare and Medicaid Services API Reference API
Centers for Medicare and Medicaid Services Bulk Data API
Centers for Medicare and Medicaid Services Code Search API
Centers for Medicare and Medicaid Services Cost Search API
Centers for Medicare and Medicaid Services Enrollments API
Centers for Medicare and Medicaid Services Households & Eligibility API
Centers for Medicare and Medicaid Services Insurance Issuers API