Skip to main content
GET
/
blocks
Get Census Block Data with Provider Coverage
curl --request GET \
  --url https://api-sandbox.letshum.com/blocks \
  --header 'Authorization: Bearer <token>'
{ "message": "Block coverage for 2 blocks", "request_status": "ok", "data": [ { "census": { "geoid": "481210214132005", "state_fips": "48", "state_name": "Texas", "state_abbreviation": "TX", "county_fips": "121", "county_name": "Denton", "tract": "021413", "block": "2005", "population": 326, "housing_units": 123, "land_area_sq_meters": 314848, "water_area_sq_meters": 0, "urban_rural": "urban" }, "providers": [ { "provider_id": "130077", "provider_name": "AT&T", "technology": "Fiber", "technology_code": 50, "max_download_speed": 5000, "max_upload_speed": 5000 }, { "provider_id": "130317", "provider_name": "Xfinity", "technology": "Cable", "technology_code": 40, "max_download_speed": 1200, "max_upload_speed": 35 } ] }, { "census": { "geoid": "060372074023015", "state_fips": "06", "state_name": "California", "state_abbreviation": "CA", "county_fips": "037", "county_name": "Los Angeles", "tract": "207402", "block": "3015", "population": 89, "housing_units": 42, "land_area_sq_meters": 125000, "water_area_sq_meters": 0, "urban_rural": "urban" }, "providers": [ { "provider_id": "130079", "provider_name": "Spectrum", "technology": "Cable", "technology_code": 40, "max_download_speed": 1000, "max_upload_speed": 35 } ] } ], "meta": { "responded_at": "2026-02-03T22:00:00Z", "hum_data_set": "25041808", "blocks_found": 2, "blocks_requested": 2 } }

Authorizations

​
Authorization
string
header
required

Bearer token authentication using API tokens. Include the token in the Authorization header as: Authorization: Bearer <token>

Obtain tokens through your Hum API account dashboard or contact support@letshum.com for access.

Query Parameters

​
geoids[]
string[]
required

Census block GEOIDs (15 characters each). Maximum 100 blocks per request. Format: 2-digit state FIPS + 3-digit county FIPS + 6-digit tract + 4-digit block Example: 481210214132005 (Texas, Denton County, tract 021413, block 2005)

Maximum array length: 100
Pattern: ^\d{15}$

Response

Block census data with provider coverage

​
message
string
required

Human-readable summary of the response

Example:

"Block coverage for 2 blocks"

​
request_status
enum<string>
required

A status code summarizing the outcome of this response.

  • ok: Request was successful
  • warning: Request was processed but with some issues
  • error: Request failed
Available options:
ok,
warning,
error
Example:

"ok"

​
data
object[]
required

Array of block data with provider coverage

​
meta
object
required

Metadata for census block coverage response