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

    filter object

    Consolidated filter parameter for mobile network operators (deepObject style). Originally: filter[name][starts_with], filter[name][contains], filter[name][ends_with], filter[country_code], filter[mcc], filter[mnc], filter[tadig], filter[network_preferences_enabled]

    page object

    Consolidated pagination parameter (deepObject style). Originally: page[number], page[size]

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

    object[]

  • Array [

    • code stringrequired
    title stringrequired
    detail string

    source

    object

    pointer string

    JSON pointer (RFC6901) to the offending entity.

    parameter string

    Indicates which query parameter caused the error.

    meta

    object

    property name* any

  • ]

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
  }
}