# Electoral Boundaries API – Districts, Precincts, GeoJSON

Which congressional district, state legislative district, voting precinct, county, tract and place contains a US point; every district in a state; GeoJSON outlines by GEOID from Census TIGER; and administrative boundaries for every country from geoBoundaries.

$0.40 per 1,000 records

[Get an API key](https://pushbuild.com/apis/app/signup?api=electoral-boundaries)

Example request

```
POST /electoral-boundaries/run
{
  "maxItems": 20
}
```

## What it returns

Census TIGER boundaries for US elections and geoBoundaries administrative units for every country, as clean JSON and GeoJSON.

## Request

`POST https://api.pushbuild.com/electoral-boundaries/run` with a JSON body. Send your key in the `X-API-Key` header.

| Field | Type | Description |
| --- | --- | --- |
| `points` | list of strings | lat,lon pairs, e.g. 39.95,-75.16. Returns the state, county, tract, block group, place, congressional districts (119th and 120th), state legislative districts (2024 and 2026) and 2020 voting district containing each point. |
| `pointLevels` | list of strings | Optional subset of levels to look up for points (default: all). |
| `level` | string: congressionalDistrict, congressionalDistrict120, congressionalDistrict116, stateSenateDistrict, stateHouseDistrict, stateSenateDistrict2026, stateHouseDistrict2026, votingDistrict, state, county, tract, blockGroup, countySubdivision, place, cdp | Boundary level for listIn and geoids. Default: `"congressionalDistrict"`. |
| `listIn` | list of strings | State codes (PA) or FIPS (42). Returns every unit of the chosen level: GEOID, name, land and water area, centroid, 2020 population where TIGERweb carries it. |
| `geoids` | list of strings | GEOIDs of the chosen level (e.g. 4401 for RI-1). Returns the boundary as GeoJSON in WGS84. |
| `simplifyDegrees` | number | Maximum allowable offset; 0.001 is about 100 m. Use 0.0001 for detail, 0.01 for maps of a whole state. Default: `0.001`. |
| `countries` | list of strings | ISO 3166-1 alpha-3 codes (FRA, BRA, IND) for geoBoundaries administrative units. |
| `admLevels` | list of strings | ADM0 (country) to ADM5; default ADM1 (states, regions, provinces). |
| `includeUnits` | boolean | Off: one row per country and level with the source, licence, unit count and download links. Default: `true`. |
| `includeGeometry` | boolean | Add each world unit's simplified GeoJSON geometry. Default: `false`. |
| `maxItems` | integer | Maximum items to return (1-500). Default: `100`. |

### Example

```
curl -X POST https://api.pushbuild.com/electoral-boundaries/run \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"maxItems": 20}'
```

### Response

```
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
```

Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.

## Pricing

Pay only for results returned: $0.40 per 1,000 records. No charge for errors or empty searches.

## Use it from Claude, ChatGPT or Cursor

This API is also an MCP server: `https://api.pushbuild.com/mcp/electoral-boundaries`. Add it to any assistant that supports remote MCP servers, with your key in the `X-API-Key` header. Same prices. [Setup for each app](https://pushbuild.com/apis/mcp.html).

## Related APIs

- [Ensembl Gene API](https://pushbuild.com/apis/ensembl-gene-lookup.html): Look up genes in Ensembl by symbol or Ensembl ID: chromosome, start and end position, strand, biotype, description, canonical transcript and assembly, for human and 300+ other species..
- [EPA Toxics Release API](https://pushbuild.com/apis/epa-toxics-release-inventory.html): EPA Toxics Release Inventory (TRI): industrial facilities that report toxic chemical releases, searchable by state, city, ZIP or county, and their yearly chemical reports with pounds released to air, water and land by medium..
- [EPSS API](https://pushbuild.com/apis/epss-exploit-scores.html): EPSS exploit prediction scores from FIRST: the probability each CVE will be exploited in the next 30 days and its percentile, for chosen CVEs or the riskiest CVEs overall, on any date..
- [Drug Lookup API](https://pushbuild.com/apis/rxnorm-drugs.html): Look up US prescription and OTC drugs by brand or generic name, RxCUI or NDC.
- [Drug Label API](https://pushbuild.com/apis/dailymed-drug-labels.html): FDA drug labels from DailyMed (US National Library of Medicine): search by drug name, NDC or labeler, with set ID, version, published date and label sections: boxed warning, indications, dosage, contraindications, warnings, adverse reactions, interactions..
- [Domain Intelligence: WHOIS/RDAP, DNS, SSL, Tech API](https://pushbuild.com/apis/domain-intelligence.html): For any list of domains: registrar, creation and expiry dates, nameservers (RDAP/WHOIS), A/MX/SPF/DMARC records, email provider, SSL certificate issuer and expiry, HTTP status and detected technologies (Shopify, WordPress, HubSpot, Stripe…)..

## Tell us what you need built.

Questions about this API, higher volumes, or a data source you need that we don't cover yet.

[hello@pushbuild.com](mailto:hello@pushbuild.com?subject=API%20question)

[(617) 299-8887](tel:+16172998887)

---
As of 2026-11-05. Source: https://pushbuild.com/apis/electoral-boundaries.html