Census Tract Lookup
Census tract, county, and congressional and school districts for a US address.
curl -X POST https://api.1lookup.dev/v1/census-tract-lookup \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"address":"1200 Example Ave, Austin, TX 78701"}'{
"success": true,
"data": {
"input_address": "1200 Example Ave, Austin, TX 78701",
"matched": true,
"matched_address": "1200 EXAMPLE AVE, AUSTIN, TX, 78701",
"coordinates": {
"lat": 30.2711,
"lng": -97.7437
},
"fips": {
"state": "48",
"county": "453",
"county_name": "Travis County"
},
"tract": {
"code": "001100",
"name": "Census Tract 11",
"geoid": "48453001100"
},
"block_group": "2",
"block": "2014",
"districts": {
"congressional": "37",
"state_senate": "14",
"state_house": "49",
"school": "Austin Independent School District"
}
},
"meta": {
"credits_used": 2,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}Authorization
Authorizationstring<bearer>requiredYour API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.
Body
Send the fields as a JSON object with Content-Type: application/json.
addressstringrequiredUS street address. Example: 1200 Example Ave, Austin, TX 78701
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
Response
A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.
successbooleantrue when the lookup ran.
data.matched_addressstringThe standardized address the Census Geocoder matched your input to.
data.coordinatesobjectLatitude and longitude for the matched address.
data.fips.countystringThe three-digit county code, returned with the two-digit state code and county name.
data.tract.geoidstringThe 11-digit identifier that joins to Census Bureau data tables.
data.block_groupstringThe block group within the tract, for finer-grained demographic joins.
data.districts.congressionalstringThe US House district the address falls in.
data.districts.state_senatestringThe upper chamber district, returned next to the lower chamber district.
data.districts.schoolstringThe school district that serves the address.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Errors
A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An upstream source did not answer in time. Safe to retry. |
Billing
2 credits. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.
Product overview and use cases