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 Disease Control and Prevention SODA v2.1 API

Stable Socrata Open Data API used for the majority of data.cdc.gov queries.

Centers for Disease Control and Prevention SODA v2.1 API is one of 9 APIs that Centers for Disease Control and Prevention publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include SODA v2.1. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 3 operations across 3 paths. It is described by OpenAPI 3.1.0, at version 2.1.

Requests are made against 2 base URLs: https://data.cdc.gov, https://chronicdata.cdc.gov.

3 operations 3 paths 0 schemas 3 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.1
Base URL
https://data.cdc.gov/resource/
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Centers for Disease Control and Prevention SODA v2.1 API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-App-Token (appToken). By default, every request must be authenticated, though some operations may also be called without credentials.

  • appToken — Socrata application token. Anonymous use is allowed at throttled rates; an app token raises rate limits. May also be supplied as the $$apptoken query parameter.

Paths & Operations 3

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

SODA v2.1 3

Stable Socrata Open Data API used for the majority of data.cdc.gov queries.

GET
/resource/{dataset_id}.json
Query a dataset (JSON)
queryDatasetJson 11 params → 200400401403404429
GET
/resource/{dataset_id}.csv
Query a dataset (CSV)
queryDatasetCsv 10 params → 200400404
GET
/resource/{dataset_id}.geojson
Query a dataset (GeoJSON)
queryDatasetGeoJson 6 params → 200400404

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

centers-for-disease-control-and-prevention-soda-v2-1-api-openapi.yml Raw ↑

Other APIs Centers for Disease Control and Prevention publishes across the network.

CDC Socrata Open Data API (data.cdc.gov)
CDC WONDER API
CDC PLACES / 500 Cities API
CDC Environmental Public Health Tracking Network API
CDC Public Health Media Library (Content Syndication)
CDC Open Technology API Index
CDC NNDSS / MMWR Socrata Data
Centers for Disease Control and Prevention SODA v3 API