Catalog

Get network coverage

Returns a list of supported local telecom providers (networks) for the specified region. Use this to display network coverage information to users or to verify connectivity options in a specific region.

get/catalog/coverage/{regionCode}

Authorization

Authorization: Bearer {token} — an OAuth2 access token from the client-credentials flow. How authentication works

Path parameters

regionCodestringrequired

ISO 3166-1 alpha-2 region code (e.g., "US", "DE", "JP")

Responses

200List of supported networks in the regionapplication/json

Show response body

dataobjectrequired

Show properties

countryCodestringrequired

ISO 3166-1 alpha-2 region code

countryCodeAlpha3string | null

ISO 3166-1 alpha-3 region code. Null for special regions like Global.

namestringrequired

Region name

networksarray of Networkrequired

List of supported telecom networks in this region

Show properties

namestringrequired

Network operator name

mccstringrequired

Mobile Country Code

mncstringrequired

Mobile Network Code

technologiesarray of string

Supported network technologies

Options2G3G4G5G

coverageTypestring

Type of coverage arrangement

Optionsnativeroaming

404Region not found or not supportedapplication/json

Show response body

typestring · urirequired

URI reference to error documentation

titlestringrequired

Short, consistent error summary

statusintegerrequired

HTTP status code

detailstringrequired

Human-readable explanation specific to this occurrence

400Bad request - invalid parameters 401Unauthorized - missing or invalid API key 403Forbidden - client does not have access to this resource 429Rate limit exceeded 500Internal server error

Request

curl 'https://connect.firsty.app/api/v3/catalog/coverage/{regionCode}' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

fetch('https://connect.firsty.app/api/v3/catalog/coverage/{regionCode}', {
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN'
  }
})

requests.get(
    "https://connect.firsty.app/api/v3/catalog/coverage/{regionCode}",
    headers={
      "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    }
)

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://connect.firsty.app/api/v3/catalog/coverage/{regionCode}', [
  'headers' => [
    'Authorization' => 'Bearer YOUR_ACCESS_TOKEN'
  ]
]);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	requestUrl := "https://connect.firsty.app/api/v3/catalog/coverage/%7BregionCode%7D"

	req, _ := http.NewRequest("GET", requestUrl, nil)

	req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

curl 'https://connect.test.firsty.app/api/v3/catalog/coverage/{regionCode}' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

fetch('https://connect.test.firsty.app/api/v3/catalog/coverage/{regionCode}', {
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN'
  }
})

requests.get(
    "https://connect.test.firsty.app/api/v3/catalog/coverage/{regionCode}",
    headers={
      "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    }
)

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://connect.test.firsty.app/api/v3/catalog/coverage/{regionCode}', [
  'headers' => [
    'Authorization' => 'Bearer YOUR_ACCESS_TOKEN'
  ]
]);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	requestUrl := "https://connect.test.firsty.app/api/v3/catalog/coverage/%7BregionCode%7D"

	req, _ := http.NewRequest("GET", requestUrl, nil)

	req.Header.Add("Authorization", "Bearer YOUR_ACCESS_TOKEN")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}

Response

{
  "data": {
    "countryCode": "US",
    "countryCodeAlpha3": "USA",
    "name": "United States",
    "networks": [
      {
        "name": "T-Mobile",
        "mcc": "310",
        "mnc": "260",
        "technologies": [
          "4G",
          "5G"
        ],
        "coverageType": "native"
      }
    ]
  }
}

{
  "type": "https://developers.firsty.app/errors/validation-failed",
  "title": "Validation failed",
  "status": 400,
  "detail": "Request contains invalid fields",
  "errors": [
    {
      "field": "planReference",
      "detail": "Must be a valid 14-character plan reference"
    }
  ]
}

{
  "type": "https://developers.firsty.app/errors/not-found",
  "title": "Not found",
  "status": 404,
  "detail": "eSIM not found"
}