Informational

Get FCC Service Providers

Retrieves a comprehensive list of FCC service providers and their supplemental brands. This endpoint provides access to the complete database of Internet service providers that are tracked by the FCC and used by Hum for service availability lookups.

Use Cases

  • Building provider selection interfaces
  • Validating provider names and IDs
  • Understanding provider coverage and scale
  • Integration with external systems

Data Structure

The response includes both primary FCC providers and their supplemental brands:

  • Primary Providers: Main FCC-registered service providers
  • Supplemental Brands: Subsidiary brands and service lines under parent providers
  • Total Residential Units: Coverage metrics for each provider

Provider Types

  • fcc_provider: Primary FCC-registered service provider
  • supplemental_brand: Supplemental brand that inherits coverage from parent provider
  • Supplemental brands are grouped immediately after their parent provider

Response Format

Providers are ordered by total residential units (largest first) with supplemental brands immediately following their parent provider in the list.

Example Response

{
  "providers": [
    {
      "id": "130403",
      "name": "T-Mobile",
      "fcc_name": "T-Mobile USA, Inc.",
      "total_residential_units": 97951103,
      "type": "fcc_provider"
    },
    { 
        "id": "130077",
        "name": "AT&T",
        "fcc_name": "AT&T Inc.",
        "total_residential_units": 80864481,
        "type": "fcc_provider"
    },
    {
        "id": "130317",
        "name": "Xfinity",
        "fcc_name": "Comcast Corporation",
        "total_residential_units": 57287455,
        "type": "fcc_provider"
    },
    {
        "id": "130317-1",
        "name": "Now XFinity",
        "fcc_name": "Comcast Corporation",
        "total_residential_units": 57287455,
        "type": "supplemental_brand"
    },
    {
        "id": "131425",
        "name": "Verizon",
        "fcc_name": "Verizon Communications Inc.",
        "total_residential_units": 50554772,
        "type": "fcc_provider"
    }
  ]
}

Important Notes

  • All requests require a valid bearer token
  • Response includes both active and inactive providers
  • Supplemental brands reference their parent provider's FCC name
  • Total residential units represent the parent provider's coverage
get/service_providers

Response

Service providers retrieved successfully

Example response

{
  "providers": [
    {
      "id": "12345",
      "name": "Comcast Cable Communications",
      "fcc_name": "Comcast Cable Communications, LLC",
      "total_residential_units": 50000000,
      "type": "fcc_provider"
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.