CDC/ATSDR Social Vulnerability Index API

What you can build

Official overall and theme percentile ranks with underlying estimates and margins of error. National and Puerto Rico rankings are separate; missing values are not zero and ranks cannot be averaged or compared across editions. Use this dataset as a sourced input to an application, analytical model or retrieval tool. Retain its native dimensions when joining it with your own records.

Query CDC/ATSDR Social Vulnerability Index

The example below is a real bounded request against the available release. Replace the environment variable with your server-side API credential. Review endpoint parameters and response schemas before changing selectors.

curl --fail --get "https://api.geoamcan.com/v1/health/social-vulnerability?ranking_scope=us&geo_type=tract&geoid=01001020100&metrics=RPL_THEMES%2CRPL_THEME1%2CE_TOTPOP&include_geometry=True" \
  -H "Authorization: Bearer $GEOAMCAN_API_KEY"

Saved response excerpt

{
  "requested_area": {
    "geo_type": "tract",
    "geoid": "01001020100",
    "state": null,
    "ranking_scope": "us",
    "year": 2022,
    "metrics": "RPL_THEMES,RPL_THEME1,E_TOTPOP",
    "include_geometry": true
  },
  "data": [
    {
      "period": "2022",
      "ranking_scope": "us",
      "geo_type": "tract",
      "geoid": "01001020100",
      "name": "Census Tract 201; Autauga County; Alabama",
      "metrics": {
        "E_TOTPOP": 1865,
        "RPL_THEME1": 0.488,
        "RPL_THEMES": 0.3635
      },
      "flags": {
        "missing": {},
        "ranking_universe": "us",
        "source_geography": "Native identifiers from the 2022 SVI source; exact edition retained"
      },
      "margins_of_error": {
        "E_TOTPOP": 368
      },
      "estimate_moe_confidence": 0.9,
      "geometry_vintage": "2020",
      "geometry_join": "same_code_display_boundary"
    }
  ],
  "availability": {
    "status": "available",
    "coverage": [
      {
        "period": "2022",
        "records": 78,
        "geo_type": "county",
        "ranking_scope": "puerto_rico"
      }
    ],
    "periods_for_selected_sector": [
      "2022"
    ]
  },
  "snapshot": {
    "cdc-svi": {
      "release_id": 107,
      "release": "2022; official US and separate Puerto Rico rankings parser v1 job 131",
      "fingerprint": "6419d81503b328ff2913600319f7a6a0"
    },
    "tiger": {
      "release_id": 1,
      "release": "2026 + native 2024/2020",
      "fingerprint": "0400658a689c0c2b04db479935dae54a"
    }
  },
  "returned_count": 1,
  "complete": true,
  "next_offset": null,
  "limitations": [
    "Official overall and theme percentile ranks with underlying estimates and margins of error. National and Puerto Rico rankings are separate; missing values are not zero and ranks cannot be averaged or compared across editions."
  ],
  "source_attribution": {
    "cdc-svi": "CDC / ATSDR — https://atsdr.cdc.gov/place-health/php/svi/svi-data-documentation-download.html"
  },
  "metric_definitions": {
    "RPL_THEMES": {
      "label": "Overall social vulnerability percentile rank",
      "unit": "percentile_rank_0_1"
    },
    "RPL_THEME1": {
      "label": "Socioeconomic status percentile rank",
      "unit": "percentile_rank_0_1"
    },
    "RPL_THEME2": {
      "label": "Household characteristics percentile rank",
      "unit": "percentile_rank_0_1"
    },
    "RPL_THEME3": {
      "label": "Racial and ethnic minority status percentile rank",
      "unit": "percentile_rank_0_1"
    },
    "RPL_THEME4": {
      "label": "Housing type and transportation percentile rank",
      "unit": "percentile_rank_0_1"
    },
    "E_TOTPOP": {
      "label": "ACS total population estimate",
      "unit": "persons"
    },
    "source_dictionary": {
      "url": "https://svi2.cdc.gov/webapi/documents/publication?filename=SVI2022Documentation_ZCTA",
      "meaning": "E_: estimate, M_: estimate margin of error, EP_: percentage, MP_: percentage margin of error; underlying variable universes are in the official dictionary."
    }
  }
}

Captured 2026-11-04. Excerpt omits pagination credentials and may shorten nested records. Download verified source responses.

Coverage and interpretation

Coverage is limited to published source geographies and releases. Missing, suppressed and unavailable observations must not be treated as zero.

The active release shown here is a catalog snapshot. Check the live catalog and response provenance for current readiness. The underlying public source and Geoamcan access terms are separate; consult the source’s licensing and attribution requirements.

Source and methodology

Source: CDC / ATSDR. Geoamcan is an independent API provider, with no agency affiliation or endorsement. Read our data methodology for source handling, geographic joins and update practices.

Related data

• FDIC Summary of Deposits
• BLS Occupational Employment and Wage Statistics
• NCES School and Postsecondary Locations
• FHFA Local House Price Index