Service Availability
Get Internet Service Availability
Retrieves available Internet service providers and their offerings for the service address associated with the current session.
Data Provided
- Internet Service Providers (ISPs)
- Available plans and pricing
- Technology types (Fiber, Cable, DSL, etc.)
- Maximum speeds
- Provider contact information
- Checkout URLs
Response Timing
- Initial request may return 202 if still processing
- Results typically available within 5-15 seconds
- Implement polling with backoff strategy
Data Freshness
- Results cached for 24 hours
- Real-time availability checks on checkout
- Pricing updated daily
- Coverage maps updated weekly
Example Response
{
"message": "Service coverage for 29090 TIFFANY DR E, SOUTHFIELD, MI 48034",
"request_status": "ok",
"data": {
"internet": [
{
"provider_id": "0c970c65-7b01-3fc4-91ee-4ecb31f2acb8",
"provider_name": "Rocket Fiber",
"telephone": "+18005215881",
"provider_icon": null,
"provider_logo": "https://harmony.letshum.com/images/providers/rocketfiber.png",
"url": "https://provider.example.com/register?utm_source=Hum",
"button_label": "Get Started",
"min_plan_price": {
"amount_cents": 4999,
"currency": "USD"
},
"promo_text": "",
"promo_logo": "",
"offerings": [
{
"technology": "Fiber",
"technology_category": "Terrestrial",
"max_download_speed": 1000,
"max_upload_speed": 1000
}
],
"product_catalog": []
}
]
},
"meta": {
"session_token": "XqCmeTVgYXrbWrZFZEymkD",
"session_status": "open",
"responded_at": "2025-05-23T17:14:41.903Z",
"hum_data_set": "25041808"
}
}
Note: Some providers may return an empty product_catalog
array.
GET
Authorizations
Bearer token authentication using JWT 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.
Path Parameters
The session token identifying the specific session
Example:
"XqCmeTVgYXrbWrZFZEymkD"
Response
200
application/json
Internet service providers, available plans, and logos/urls for a given service address.
The response is of type object
.