health

Current US notifiable-disease surveillance from the CDC...

Current US notifiable-disease surveillance from the CDC NNDSS (National Notifiable Diseases Surveillance System) weekly tables. Returns provisional weekly case counts for ~139 nationally notifiable conditions (e.g. Measles, Pertussis, Mumps, Hepatitis A, Lyme disease, Gonorrhea, West Nile, Dengue) by reporting area and MMWR week, updated weekly. Filter by condition (substring, case-insensitive: "measles" matches "Measles, Indigenous"), location (a reporting area: a US state full name like "California", "New York City", "U.S. Residents", a census region like "Pacific", or a territory), year (MMWR year, 2022 to current), and weeks (most-recent N observations). At least one of condition or location is required. Each record reports the current-week count, the previous-52-week maximum, cumulative cases YTD this MMWR year, and cumulative YTD the prior year for same-week comparison. Public-domain CDC federal data via data.cdc.gov. Use this to see live disease activity and outbreaks that postdate an agent's training cutoff.

get/api/health/disease-surveillance

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/health/disease-surveillance
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

conditionstring

Disease/condition substring, case-insensitive.

locationstring

Reporting area: state, NYC, U.S. Residents, census region, or territory.

yearinteger

MMWR year, 2022 to current.

weeksinteger

Return roughly the most-recent N weeks of observations.

limitinteger

Maximum number of results to return.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.