Skip to Content
OpenRoam Docs
Reference data

List mobile networks

Lists mobile network codes (MCC/MNC) with their operator, country and calling code.

GET
/v1/common/mccmnc

Lists mobile network codes (MCC/MNC) with their operator, country and calling code.

Returns { items } ordered by mcc then mnc, without paging. Optional filters: countryCode (ISO 3166-1 alpha-2, either case) and mcc (3 digits); both together return the networks matching both. A malformed filter or an unknown query parameter returns 400 with code 10001.

Authorization

PartnerApiKey
headerX-Partner-Key<token>

Partner API Key (X-Partner-Key)

Query Parameters

countryCode?string

Only networks of this country: an ISO 3166-1 alpha-2 code, in either case.

mcc?string

Only networks with this 3-digit mobile country code, for example 400.

Response Body

OK

  1. response

Mobile network codes ordered by MCC then MNC. The list is a few thousand rows of reference data, so it is not paged.

items*array<>
Example Request
curl -X GET 'https://api.sandbox.openroam.com/v1/common/mccmnc?mcc=400'
Example Response
{  "items": [    {      "mcc": "string",      "mnc": "string",      "countryCode": "string",      "countryName": "string",      "operator": "string",      "dialCode": "string"    }  ]}