Search by task, endpoint, field, or error.
District API
A district by code or name, with its state and timezones.
Look up one district by code or name. US county FIPS, French INSEE departments, and GB GSS districts, the same codes /point and /postal hand back. /district/guilford county and /district/edinburgh resolve on their own. Type suffixes fold, so /district/guilford works too.
A name shared across districts needs ?state= or ?country=. Short state codes can also be shared across countries. For Louisiana, use its name or pair ?state=LA with ?country=US. Codes rarely collide. When one does, you get a 400 asking for country.
Lookup
Parameters 6
- formatstring · query · optional
json by default. geojson returns simplified administrative Polygon/MultiPolygon outlines with country-qualified IDs and selected facts in properties. Coordinates are longitude first. Missing or ambiguous outlines retain null geometry. Unavailable boundary storage returns 503. Collections retain parent context. Existing Deep access and pooled allowance apply. API 2.0.0 only.
Default:
jsonValues:
json, geojson- codestring · path · required
District code or name (08031, guilford county, E09000033)
- countrystring · query · optional
ISO2, ISO3, or a country name. Optional when the code or name is unique.
- statestring · query · optional
ADM1 code or name. Narrows name lookups. Prefer louisiana over LA, which collides across countries, or include country=US.
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
- deepboolean · query · optional
Population, area, the seat of government and US county property-tax medians. Included on paid plans.
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.district("08031", { deep: true });
console.log(result);Run on your server with a secret key. Calling from a browser or app?
{
"district": "08031",
"name": "Denver County",
"type": "county",
"state": "CO",
"state_name": "Colorado",
"country": "US",
"country_name": "United States",
"latitude": 39.76185,
"longitude": -104.881105,
"timezones": [
"America/Denver"
],
"deep": {
"population": 729019,
"area": 400.74,
"land_area": 396.46,
"water_area": 4.28,
"seat": "Denver",
"property_tax": {
"annual_median": 2751,
"currency": "USD",
"period": "2020-2024"
}
}
}Response fields
- districtstring or null
- District code (US county FIPS, FR INSEE department, GB GSS)
- namestring or null
- Name
- typestring or null
- County, department, district, etc.
- statestring or null
- State or province code
- state_namestring or null
- State or province name
- countrystring or null
- ISO2 country code
- country_namestring or null
- Country name
- latitudenumber or null
- Centroid latitude
- longitudenumber or null
- Centroid longitude
- timezonesarray or null
- Every IANA timezone in the district
Every district in a state instead? Use /state/{code}/districts.
GeoJSON administrative district outlines
Add format=geojson on API 2.0.0 for a simplified Polygon or MultiPolygon Feature. Its stable id combines the country and district code, such as US-08031. The same selected facts and requested Deep profile stay in properties. Coordinates use WGS84 [longitude, latitude].
curl "https://api.parseapi.com/district/08031?country=US&format=geojson" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Parse-Version: 2.0.0"curl "https://api.parseapi.com/district/08031?country=US&format=geojson" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Parse-Version: 2.0.0"Run on your server with a secret key. Calling from a browser or app?
{
"type": "Feature",
"id": "US-08031",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
-104.932,
39.7
],
[
-104.934,
39.698
],
[
-104.932,
39.698
],
[
-104.932,
39.7
]
]
],
[
[
[
-105.11,
39.635
],
[
-105.108,
39.624
],
[
-105.091,
39.624
],
[
-105.091,
39.627
],
[
-105.082,
39.627
],
[
-105.084,
39.631
],
[
-105.081,
39.631
],
[
-105.076,
39.624
],
[
-105.065,
39.62
],
[
-105.097,
39.618
],
[
-105.097,
39.615
],
[
-105.091,
39.614
],
[
-105.058,
39.614
],
[
-105.057,
39.621
],
[
-105.054,
39.621
],
[
-105.056,
39.624
],
[
-105.053,
39.63
],
[
-105.06,
39.635
],
[
-105.059,
39.639
],
[
-105.053,
39.639
],
[
-105.053,
39.632
],
[
-105.044,
39.631
],
[
-105.043,
39.628
],
[
-105.025,
39.629
],
[
-105.025,
39.631
],
[
-105.035,
39.633
],
[
-105.035,
39.639
],
[
-105.03,
39.639
],
[
-105.03,
39.642
],
[
-105.035,
39.644
],
[
-105.035,
39.653
],
[
-105.032,
39.653
],
[
-105.033,
39.657
],
[
-105.023,
39.657
],
[
-105.023,
39.66
],
[
-105.016,
39.661
],
[
-105.016,
39.679
],
[
-105.009,
39.679
],
[
-105.006,
39.668
],
[
-105.011,
39.661
],
[
-105.004,
39.66
],
[
-105.004,
39.667
],
[
-105,
39.668
],
[
-104.973,
39.668
],
[
-104.969,
39.666
],
[
-104.969,
39.66
],
[
-104.959,
39.662
],
[
-104.959,
39.657
],
[
-104.954,
39.657
],
[
-104.955,
39.653
],
[
-104.932,
39.653
],
[
-104.932,
39.646
],
[
-104.922,
39.646
],
[
-104.913,
39.639
],
[
-104.913,
39.624
],
[
-104.903,
39.624
],
[
-104.885,
39.624
],
[
-104.885,
39.639
],
[
-104.88,
39.641
],
[
-104.88,
39.653
],
[
-104.875,
39.651
],
[
-104.876,
39.645
],
[
-104.847,
39.657
],
[
-104.855,
39.661
],
[
-104.866,
39.66
],
[
-104.866,
39.671
],
[
-104.871,
39.675
],
[
-104.877,
39.672
],
[
-104.876,
39.664
],
[
-104.885,
39.667
],
[
-104.89,
39.668
],
[
-104.89,
39.665
],
[
-104.894,
39.668
],
[
-104.904,
39.668
],
[
-104.904,
39.677
],
[
-104.908,
39.68
],
[
-104.905,
39.68
],
[
-104.905,
39.686
],
[
-104.903,
39.679
],
[
-104.895,
39.678
],
[
-104.894,
39.682
],
[
-104.889,
39.682
],
[
-104.889,
39.686
],
[
-104.894,
39.686
],
[
-104.894,
39.693
],
[
-104.904,
39.689
],
[
-104.904,
39.693
],
[
-104.9,
39.693
],
[
-104.904,
39.699
],
[
-104.899,
39.695
],
[
-104.878,
39.698
],
[
-104.866,
39.697
],
[
-104.868,
39.7
],
[
-104.871,
39.698
],
[
-104.866,
39.704
],
[
-104.866,
39.711
],
[
-104.871,
39.71
],
[
-104.871,
39.718
],
[
-104.875,
39.718
],
[
-104.875,
39.726
],
[
-104.882,
39.725
],
[
-104.887,
39.729
],
[
-104.885,
39.747
],
[
-104.88,
39.747
],
[
-104.88,
39.755
],
[
-104.847,
39.755
],
[
-104.856,
39.758
],
[
-104.856,
39.769
],
[
-104.833,
39.766
],
[
-104.828,
39.772
],
[
-104.782,
39.773
],
[
-104.782,
39.776
],
[
-104.772,
39.776
],
[
-104.772,
39.772
],
[
-104.765,
39.772
],
[
-104.765,
39.769
],
[
-104.735,
39.769
],
[
-104.734,
39.798
],
[
-104.763,
39.798
],
[
-104.762,
39.823
],
[
-104.666,
39.823
],
[
-104.666,
39.813
],
[
-104.655,
39.813
],
[
-104.655,
39.823
],
[
-104.62,
39.822
],
[
-104.619,
39.873
],
[
-104.605,
39.873
],
[
-104.605,
39.881
],
[
-104.6,
39.881
],
[
-104.6,
39.899
],
[
-104.631,
39.899
],
[
-104.631,
39.907
],
[
-104.68,
39.907
],
[
-104.68,
39.914
],
[
-104.692,
39.914
],
[
-104.692,
39.907
],
[
-104.703,
39.907
],
[
-104.703,
39.896
],
[
-104.73,
39.896
],
[
-104.731,
39.845
],
[
-104.791,
39.842
],
[
-104.791,
39.798
],
[
-104.866,
39.798
],
[
-104.866,
39.813
],
[
-104.884,
39.813
],
[
-104.884,
39.798
],
[
-104.904,
39.798
],
[
-104.903,
39.784
],
[
-104.927,
39.784
],
[
-104.927,
39.791
],
[
-104.94,
39.791
],
[
-104.94,
39.795
],
[
-104.969,
39.791
],
[
-104.969,
39.798
],
[
-104.975,
39.796
],
[
-104.973,
39.792
],
[
-104.976,
39.791
],
[
-105.021,
39.791
],
[
-105.022,
39.794
],
[
-105.025,
39.791
],
[
-105.064,
39.791
],
[
-105.063,
39.784
],
[
-105.053,
39.784
],
[
-105.053,
39.735
],
[
-105.056,
39.735
],
[
-105.053,
39.733
],
[
-105.053,
39.682
],
[
-105.058,
39.682
],
[
-105.058,
39.679
],
[
-105.063,
39.679
],
[
-105.063,
39.675
],
[
-105.053,
39.675
],
[
-105.053,
39.668
],
[
-105.081,
39.67
],
[
-105.081,
39.662
],
[
-105.067,
39.657
],
[
-105.071,
39.65
],
[
-105.063,
39.652
],
[
-105.057,
39.653
],
[
-105.054,
39.651
],
[
-105.074,
39.644
],
[
-105.077,
39.639
],
[
-105.073,
39.637
],
[
-105.091,
39.639
],
[
-105.091,
39.635
],
[
-105.11,
39.635
]
],
[
[
-104.908,
39.682
],
[
-104.908,
39.68
],
[
-104.911,
39.682
],
[
-104.908,
39.682
]
],
[
[
-104.904,
39.627
],
[
-104.903,
39.624
],
[
-104.904,
39.625
],
[
-104.904,
39.627
]
],
[
[
-104.941,
39.698
],
[
-104.941,
39.711
],
[
-104.932,
39.711
],
[
-104.927,
39.704
],
[
-104.934,
39.704
],
[
-104.934,
39.701
],
[
-104.929,
39.7
],
[
-104.928,
39.697
],
[
-104.934,
39.698
],
[
-104.936,
39.698
],
[
-104.936,
39.695
],
[
-104.941,
39.695
],
[
-104.939,
39.698
],
[
-104.941,
39.698
]
],
[
[
-104.932,
39.667
],
[
-104.934,
39.671
],
[
-104.932,
39.673
],
[
-104.927,
39.669
],
[
-104.932,
39.667
]
],
[
[
-104.926,
39.669
],
[
-104.927,
39.669
],
[
-104.93,
39.675
],
[
-104.926,
39.677
],
[
-104.918,
39.673
],
[
-104.913,
39.656
],
[
-104.921,
39.66
],
[
-104.921,
39.668
],
[
-104.926,
39.669
]
],
[
[
-104.899,
39.683
],
[
-104.903,
39.686
],
[
-104.899,
39.686
],
[
-104.899,
39.683
]
]
]
]
},
"properties": {
"district": "08031",
"name": "Denver County",
"type": "county",
"state": "CO",
"state_name": "Colorado",
"country": "US",
"country_name": "United States",
"latitude": 39.76185,
"longitude": -104.881105,
"timezones": [
"America/Denver"
]
}
}/state/CO/districts?country=US&format=geojson returns a FeatureCollection in the existing list order. Parent country and state context stays on the collection and in each Feature's properties. Collection facts remain the same as the ordinary list. Outline collections are larger than ordinary JSON.
Coverage varies by place. An exact outline that is missing or ambiguous stays geometry: null, even when center coordinates are known. Small islands and holes may be omitted from the simplified display outline. Unavailable boundary storage returns HTTP 503. These are administrative areas. District does not provide electoral constituencies. Outlines do not establish legal borders or survey measurements.
Omit format or use format=json for the ordinary response. Existing paid Deep access and pooled request allowances apply. Use HTTP for GeoJSON. Published SDK and MCP methods retain ordinary JSON. API 1.0.0 is unchanged.
Deep
?deep=true Population, area, the seat of government and US county property-tax medians. Included on paid plans.
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.district("08031", { deep: true });
console.log(result);Run on your server with a secret key. Calling from a browser or app?
{
"district": "08031",
"name": "Denver County",
"type": "county",
"state": "CO",
"state_name": "Colorado",
"country": "US",
"country_name": "United States",
"latitude": 39.76185,
"longitude": -104.881105,
"timezones": [
"America/Denver"
],
"deep": {
"population": 729019,
"area": 400.74,
"land_area": 396.46,
"water_area": 4.28,
"seat": "Denver",
"property_tax": {
"annual_median": 2751,
"currency": "USD",
"period": "2020-2024"
}
}
}Deep fields
- deep.populationinteger or null
- Population estimate
- deep.areanumber or null
- Total area in km² (land + water, or the official total)
- deep.land_areanumber or null
- Land area in km² (null when the source publishes total only)
- deep.water_areanumber or null
- Water area in km² (null when the source publishes total only)
- deep.seatstring or null
- Seat of government (county seat, prefecture, admin centre)
- deep.property_taxobject or null
- Median annual real-estate tax payable on owner-occupied housing, in US dollars adjusted to the final year of period. Available US ZIP-area and county estimates only. Not a percentage or an individual property bill. Null when missing, censored or unsupported.
- deep.property_tax.annual_medianinteger
- Median annual amount in currency. Dollars adjusted to the final year of period
- deep.property_tax.currencystring
- USD
- deep.property_tax.periodstring
- Observation period, such as 2020-2024
Display language
Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Existing country_name and separately sourced state or district names when available.
Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.
Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.
Content-Language identifies languages used in translated display fields and known English fallbacks. This option follows the current API contract. Requests selecting frozen 1.0.0 retain that contract. Select API 2.0.0 to use display language.
33 display language choices
| Language tag | Language |
|---|---|
| en | English |
| ar | العربية |
| ca | català |
| hr | hrvatski |
| cs | čeština |
| da | dansk |
| nl | Nederlands |
| fi | suomi |
| fr | français |
| de | Deutsch |
| el | Ελληνικά |
| he | עברית |
| hi | हिन्दी |
| hu | magyar |
| id | Indonesia |
| it | italiano |
| ja | 日本語 |
| ko | 한국어 |
| ms | Melayu |
| nb | norsk bokmål |
| pl | polski |
| pt | português |
| ro | română |
| ru | русский |
| zh-Hans | 简体中文 |
| sk | slovenčina |
| es | español |
| sv | svenska |
| th | ไทย |
| zh-Hant | 繁體中文 |
| tr | Türkçe |
| uk | українська |
| vi | Tiếng Việt |
Questions? Email