Skip to main content

List mobile network operators

GET 
/mobile_network_operators

Telnyx has a set of GSM mobile operators partners that are available through our mobile network roaming. This resource is entirely managed by Telnyx and may change over time. That means that this resource won't allow any write operations for it. Still, it's available so it can be used as a support resource that can be related to other resources or become a configuration option.

Request ​

Query Parameters

    page[number] integer

    Possible values: >= 1

    Default value: 1

    The page number to load.

    page[size] integer

    Possible values: >= 1 and <= 250

    Default value: 20

    The size of the page.

    filter[name][starts_with] string

    Filter by name starting with.

    filter[name][contains] string

    Filter by name containing match.

    filter[name][ends_with] string

    Filter by name ending with.

    filter[country_code] string

    Filter by exact country_code.

    filter[mcc] string

    Filter by exact MCC.

    filter[mnc] string

    Filter by exact MNC.

    filter[tadig] string

    Filter by exact TADIG.

    filter[network_preferences_enabled] boolean

    Filter by network_preferences_enabled.

Responses ​

200: Successful Response

Schema

    data

    object[]

  • Array [

    • id uuid

    Identifies the resource.

    record_type string

    Identifies the type of the resource.

    name string

    The network operator name.

    tadig string

    TADIG stands for Transferred Account Data Interchange Group. The TADIG code is a unique identifier for network operators in GSM mobile networks.

    country_code string

    The mobile operator two-character (ISO 3166-1 alpha-2) origin country code.

    mcc string

    MCC stands for Mobile Country Code. It's a three decimal digit that identifies a country.

    This code is commonly seen joined with a Mobile Network Code (MNC) in a tuple that allows identifying a carrier known as PLMN (Public Land Mobile Network) code.

    mnc string

    MNC stands for Mobile Network Code. It's a two to three decimal digits that identify a network.

    This code is commonly seen joined with a Mobile Country Code (MCC) in a tuple that allows identifying a carrier known as PLMN (Public Land Mobile Network) code.

    network_preferences_enabled boolean

    Indicate whether the mobile network operator can be set as preferred in the Network Preferences API.

  • ]

    • meta

    object

    total_pages integer
    total_results integer
    page_number integer
    page_size integer

401: Unauthorized

default: Unexpected error

Schema

    errors

    Error[]

  • Array [

    • code intrequired
    title stringrequired
    detail string

    source

    object

    pointer json-pointer

    JSON pointer (RFC6901) to the offending entity.

    parameter string

    Indicates which query parameter caused the error.

    meta object

  • ]

Request samples

curl -L 'https://api.telnyx.com/v2/mobile_network_operators' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

{
  "data": [
    {
      "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
      "record_type": "mobile_network_operator",
      "name": "AT&T Mobility (USACG)",
      "tadig": "USACG",
      "country_code": "US",
      "mcc": "310",
      "mnc": "410",
      "network_preferences_enabled": true
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 55,
    "page_number": 2,
    "page_size": 25
  }
}