Skip to main content Link Menu Expand (external link) Document Search Copy Copied


This is the API documentation for accessing the CDC (cdc) endpoint of Delphi’s epidemiological data.

General topics not specific to any particular endpoint are discussed in the API overview. Such topics include: contributing, citing, and data licensing.

CDC Data


The base URL is:

See this documentation for details on specifying epiweeks, dates, and lists.



Parameter Description Type
auth password string
epiweeks epiweeks list of epiweeks
locations locations list of region/state labels


Field Description Type  
result result code: 1 = success, 2 = too many results, -2 = no results integer  
epidata list of results array of objects  
message success or error message string  

Example URLs

Code Samples