Interactive Playground credentials

Enter your Console OAuth credentials to test API requests in the playground below. Select OmaxTelecom Client Credentials as the auth identity before sending.

Client IDClient Secret

MCC-MNC API

MCC-MNC

Download schema

Service health

GET

https://api.omaxtelecom.com/tools/mcc-mnc

/health

Service health › Responses

Service operational

ServiceHealthResponse

ok

boolean · required

timestamp

string · date-time · required

Lookup operator by MCC+MNC or PLMN

POST

https://api.omaxtelecom.com/tools/mcc-mnc

/lookup

Lookup operator by MCC+MNC or PLMN › query Parameters

mcc

string

Default: 242

mnc

string

Default: 99

plmn

string

Default: 24299

Lookup operator by MCC+MNC or PLMN › Responses

Operator found

LookupSuccessResponse

success

boolean · enum · required

Enum values:

Operator · required

List operators by ISO country or dial code

POST

https://api.omaxtelecom.com/tools/mcc-mnc

/by-country

List operators by ISO country or dial code › query Parameters

iso

string

Default: NO

dial_code

string

Default: +47

List operators by ISO country or dial code › Responses

200

Operators list

ByCountrySuccessResponse

success

boolean · enum · required

Enum values:

object · required

POST/by-country

curl https://api.omaxtelecom.com/tools/mcc-mnc/by-country \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "success": true,
  "data": {
    "iso": "NO",
    "dial_code": "+47",
    "count": 2,
    "operators": [
      {
        "mcc": "242",
        "mnc": "01",
        "plmn": "24201",
        "region": "Europe",
        "country": "Norway",
        "iso": "NO",
        "dial_code": "+47",
        "dial_codes": [
          "+47"
        ],
        "operator": "Telenor Norge AS",
        "brand": "Telenor",
        "tadig": "NORTM",
        "bands": "GSM 900, UMTS 2100, LTE 800"
      },
      {
        "mcc": "242",
        "mnc": "02",
        "plmn": "24202",
        "region": "Europe",
        "country": "Norway",
        "iso": "NO",
        "dial_code": "+47",
        "dial_codes": [
          "+47"
        ],
        "operator": "Telia Norge AS",
        "brand": "Telia",
        "tadig": "NORTL",
        "bands": "GSM 900, UMTS 2100, LTE 800"
      }
    ]
  }
}

json

application/json

Search operators by name

POST

https://api.omaxtelecom.com/tools/mcc-mnc

/search

Search operators by name › query Parameters

query

string · minLength: 2 · required

Default: Telenor

iso

string

Default: NO

limit

integer · min: 1 · max: 100

Default: 10

Search operators by name › Responses

200

Search results

SearchSuccessResponse

success

boolean · enum · required

Enum values:

object · required

POST/search

curl 'https://api.omaxtelecom.com/tools/mcc-mnc/search?query=Telenor' \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "success": true,
  "data": {
    "query": "Telenor",
    "iso": "NO",
    "limit": 10,
    "count": 1,
    "operators": [
      {
        "mcc": "242",
        "mnc": "01",
        "plmn": "24201",
        "region": "Europe",
        "country": "Norway",
        "iso": "NO",
        "dial_code": "+47",
        "dial_codes": [
          "+47"
        ],
        "operator": "Telenor Norge AS",
        "brand": "Telenor",
        "tadig": "NORTM",
        "bands": "GSM 900, UMTS 2100, LTE 800"
      }
    ]
  }
}

json

application/json

Bulk operator lookup

POST

https://api.omaxtelecom.com/tools/mcc-mnc

/bulk/lookup

Bulk operator lookup › Request Body

object[] · minItems: 1 · required

Bulk operator lookup › Responses

Job accepted

BulkAcceptedResponse

success

boolean · enum · required

Enum values:

object · required

Poll bulk lookup job

GET

https://api.omaxtelecom.com/tools/mcc-mnc

/bulk/lookup/{job}

Poll bulk lookup job › path Parameters

job

string · uuid · required

Poll bulk lookup job › Responses

Job status

BulkJobResponse

success

boolean · enum · required

Enum values:

object · required

GET/bulk/lookup/{job}

curl https://api.omaxtelecom.com/tools/mcc-mnc/bulk/lookup/:job \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "success": true,
  "data": {
    "job_id": "9f3c2b1a-7d6e-4f5a-8b9c-0d1e2f3a4b5c",
    "status": "processing",
    "total_count": 2,
    "processed_count": 1,
    "failed_count": 0,
    "items": [
      {
        "plmn": "24201",
        "status": "completed",
        "result": {
          "mcc": "242",
          "mnc": "01",
          "plmn": "24201",
          "region": "Europe",
          "country": "Norway",
          "iso": "NO",
          "dial_code": "+47",
          "dial_codes": [
            "+47"
          ],
          "operator": "Telenor Norge AS",
          "brand": "Telenor",
          "tadig": "NORTM",
          "bands": "GSM 900, UMTS 2100, LTE 800"
        },
        "error": null
      },
      {
        "plmn": "24299",
        "status": "pending",
        "result": null,
        "error": null
      }
    ]
  }
}

json

application/json

Auth

Lookup operator by MCC+MNC or PLMN

POST

https://api.omaxtelecom.com/tools/mcc-mnc

/lookup

Lookup operator by MCC+MNC or PLMN › query Parameters

mcc

string

Default: 242

mnc

string

Default: 99

plmn

string

Default: 24299

Lookup operator by MCC+MNC or PLMN › Responses

Operator found

LookupSuccessResponse

success

boolean · enum · required

Enum values:

Operator · required

List operators by ISO country or dial code

POST

https://api.omaxtelecom.com/tools/mcc-mnc

/by-country

List operators by ISO country or dial code › query Parameters

iso

string

Default: NO

dial_code

string

Default: +47

List operators by ISO country or dial code › Responses

200

Operators list

ByCountrySuccessResponse

success

boolean · enum · required

Enum values:

object · required

Search operators by name

POST

https://api.omaxtelecom.com/tools/mcc-mnc

/search

Search operators by name › query Parameters

query

string · minLength: 2 · required

Default: Telenor

iso

string

Default: NO

limit

integer · min: 1 · max: 100

Default: 10

Search operators by name › Responses

200

Search results

SearchSuccessResponse

success

boolean · enum · required

Enum values:

object · required