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
  }
}

Informational

Get Census Block Data with Provider Coverage

Retrieves detailed census block data along with Internet service provider coverage for specified block GEOIDs. This endpoint provides comprehensive demographic and geographic information for each block, plus all residential service providers offering fixed broadband coverage.

Block Data Included

For each block, the response includes:

Geographic identifiers: Full GEOID, state/county/tract/block codes
Location names: State name, state abbreviation, county name
Demographics: Population count, housing unit count
Geography: Land area, water area (in square meters), urban/rural classification
Provider coverage: All service providers with residential fixed broadband in the block

Provider Data

Each provider includes:

Provider ID and name
Technology type (Fiber, Cable, DSL, Wireless, Satellite)
Maximum advertised download and upload speeds

Use Cases

Detailed analysis of specific census blocks
Property-level broadband availability research
Demographic analysis with broadband coverage overlay
Bulk lookup for multiple specific blocks

Limits

Maximum 100 blocks per request
Blocks not found in the database are reported in meta.not_found

Example Query

GET /blocks?geoids[]=481210214132005&geoids[]=060372074023015

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

Show child attributes