District demographics

The Census Bureau’s American Community Survey 5-year estimates for a contest’s district: population, citizen voting-age population, income, age, education, race and ethnicity, nativity, home ownership and poverty.

Returned by: GET /v1/contests, GET /v1/contests/{id}, GET /v1/elections/{slug}/export
Found in: District (demographics)

How it connects

On every district as demographics; with format=csv, GET /v1/contests has each value as a district_ column.

Good to know

For states, counties, congressional and state legislative districts, and the places and school districts the Census Bureau publishes; null for other local districts.
Medians are null for a district made of several Census areas, since medians can’t be added up; the shares are worked out from the summed counts.
The 2020-2024 estimates use the 2024 district lines. Where a state drew new lines for 2026, the estimates are for the old lines until the Census Bureau publishes the new ones.
From the U.S. Census Bureau (public domain). This product uses Census Bureau data but is not endorsed or certified by the Census Bureau.

Fields

Field	Type	Meaning	Example
`acs_year`	integer	The last year of the American Community Survey 5-year estimates: 2024 means 2020-2024.	`2024`
`population`	integeror null	Total population (ACS B01003).	`830235`
`citizen_voting_age_population`	integeror null	U.S. citizens 18 and over (ACS B05003): the usual denominator for turnout by population.	`616394`
`median_household_income`	integeror null	Median household income in dollars (ACS B19013). null for a district made of several Census areas, since medians can’t be combined.	`140970`
`median_age`	numberor null	Median age in years (ACS B01002). null for a district made of several Census areas.	`40`
`pct_bachelors_or_higher`	numberor null	Share of people 25 and over with a bachelor’s degree or higher, 0 to 100 (ACS B15003).	`60.34`
`pct_white_alone_not_hispanic`	numberor null	Share of people who are white alone and not Hispanic or Latino, 0 to 100 (ACS B03002).	`36.81`
`pct_black_alone`	numberor null	Share of people who are Black or African American alone, Hispanic or not, 0 to 100 (ACS B03002).	`4.98`
`pct_asian_alone`	numberor null	Share of people who are Asian alone, Hispanic or not, 0 to 100 (ACS B03002).	`35.19`
`pct_hispanic`	numberor null	Share of people who are Hispanic or Latino, of any race, 0 to 100 (ACS B03002).	`16.22`
`pct_foreign_born`	numberor null	Share of people born outside the United States, 0 to 100 (ACS B05002).	`34.05`
`pct_owner_occupied`	numberor null	Share of occupied housing units lived in by their owners, 0 to 100 (ACS B25003).	`38.21`
`pct_below_poverty`	numberor null	Share of people whose poverty status is determined who are below the poverty line, 0 to 100 (ACS B17001).	`11.15`
`source`	object	The source of the estimates.	—
`source.name`	string	Who published the estimates.	`U.S. Census Bureau, American Community Survey 2020-2024 5-year estimates`
`source.url`	stringURL	Where the estimates was published.	`https://www2.census.gov/programs-surveys/acs/summary_file/2024/table-based-SF/data/5YRDat…`
`retrieved_on`	stringYYYY-MM-DD	When we read it from the source.	`2026-11-14`

Download every dictionary as CSV or JSON.

Sample (JSON)

One district demographics as the API returns it. More in the sample data.

{
  "acs_year": 2024,
  "population": 830235,
  "citizen_voting_age_population": 616394,
  "median_household_income": 140970,
  "median_age": 40,
  "pct_bachelors_or_higher": 60.34,
  "pct_white_alone_not_hispanic": 36.81,
  "pct_black_alone": 4.98,
  "pct_asian_alone": 35.19,
  "pct_hispanic": 16.22,
  "pct_foreign_born": 34.05,
  "pct_owner_occupied": 38.21,
  "pct_below_poverty": 11.15,
  "source": {
    "name": "U.S. Census Bureau, American Community Survey 2020-2024 5-year estimates",
    "url": "https://www2.census.gov/programs-surveys/acs/summary_file/2024/table-based-SF/data/5YRData/"
  },
  "retrieved_on": "2026-11-14"
}