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