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

application/json

• Schema
• Example (from schema)

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

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

default: Unexpected error

application/json

• Schema
• Example (from schema)

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

]

{
  "errors": [
    {
      "code": "string",
      "title": "string",
      "detail": "string",
      "source": {
        "pointer": "string",
        "parameter": "string"
      },
      "meta": {}
    }
  ]
}

Loading...