---
title: "Get FCC Service Providers"
method: GET
path: "/service_providers"
tags: ["Informational"]
---

# Get FCC Service Providers

`GET /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
```json
{
  "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

## Response `200`

Service providers retrieved successfully

- object
  - `providers` object[], required — Array of service providers and their supplemental brands
    - `id` string, required — Unique provider identifier (FCC provider ID or synthetic ID for brands)
    - `name` string, required — Display name of the provider or brand
    - `fcc_name` string, required — Official FCC registered name of the parent provider
    - `total_residential_units` integer, required — Total number of residential units served by the provider
    - `type` 'fcc_provider' | 'supplemental_brand' — Type of provider - 'fcc_provider' for primary FCC providers, 'supplemental_brand' for supplemental brands

## Other responses

- `401` — Unauthorized. Use the HTTP status code, not `request_status`, to detect the error.
- `415` — The request was rejected because its content type is unsupported.
- `429` — Rate Limit Exceeded
- `500` — Unexpected internal error handled by an API controller.

---

[API](https://skmtc.dev/letshum/apis/hum-api.md) · [All operations](https://skmtc.dev/letshum/apis/hum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/letshum/hum-api/revisions/5e36540cb9b0/schema)