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 v3 API

Next-generation query and export endpoints.

Centers for Disease Control and Prevention SODA v3 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 v3. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 3 operations across 2 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 2 paths 0 schemas 2 GET1 POST

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 v3 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 2 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

SODA v3 3

Next-generation query and export endpoints.

GET
/api/v3/views/{dataset_id}/query.json
Query a dataset (SODA v3, GET)
queryDatasetV3Get 3 params → 200400401
POST
/api/v3/views/{dataset_id}/query.json
Query a dataset (SODA v3, POST)
queryDatasetV3Post 2 params body → 200400401
GET
/api/v3/views/{dataset_id}/export.{format}
Export a dataset (human-readable)
exportDatasetV3 3 params → 200404

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

centers-for-disease-control-and-prevention-soda-v3-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 v2.1 API