Skip to content
Compliance & Registries

Census Tract Lookup

Census tract, county, and congressional and school districts for a US address.

POST/v1/census-tract-lookup
2 creditsBulk supportedUS
Request
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"}'
Response
{
  "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>required

Your 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.

addressstringrequired

US street address. Example: 1200 Example Ave, Austin, TX 78701

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your 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.

successboolean

true when the lookup ran.

data.matched_addressstring

The standardized address the Census Geocoder matched your input to.

data.coordinatesobject

Latitude and longitude for the matched address.

data.fips.countystring

The three-digit county code, returned with the two-digit state code and county name.

data.tract.geoidstring

The 11-digit identifier that joins to Census Bureau data tables.

data.block_groupstring

The block group within the tract, for finer-grained demographic joins.

data.districts.congressionalstring

The US House district the address falls in.

data.districts.state_senatestring

The upper chamber district, returned next to the lower chamber district.

data.districts.schoolstring

The school district that serves the address.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote 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.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn 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