# REST API — Other endpoints (Operator, Prices, MCC/MNC, Prefixes, Number Correction)


Source: https://vertexsms.com/en/api/other

## Operator

Get information about an operator from the VertexSMS internal database.

```
GET https://api.vertexsms.com/operators/{operatorId}
```

Returned fields: `name` (string, operator name), `country` (ISO 3166-1 alpha-2), `mcc` (int), `mnc` (array).

Request:

```
GET /operators/493 HTTP/1.1
Host: api.vertexsms.com
Accept: application/json
X-VertexSMS-Token: eB52vNTPL9fO3rDrx8pYmVnj6nqceHNhnqceHNh
```

Response:

```
HTTP/1.1 200 OK
Content-Type: application/json
Cache-control: no-cache

{ "name": "BITE", "country": "LT", "mcc": "245", "mnc": ["020", "028"] }
```

## Prices

```
GET https://api.vertexsms.com/rates/?format={format}
```

Input: `format` = `json` or `csv`.

Returned fields: `CountryName` (e.g. `Taiwan`), `CountryCode` (ISO 3166-1 alpha-2), `Operator` (e.g. `VIBO Telecom`), `Network` (e.g. `VIBO`), `mcc` (int), `mnc` (string, may be null), `Rate` (price as string).

`Network` and `Operator` may also be `All` or `All other carriers`. `All` is the single default route in a country; `All other carriers` indicates more than one default route exists.

Request:

```
GET /rates/?format=json HTTP/1.1
Host: api.vertexsms.com
Accept: application/json
X-VertexSMS-Token: eB52vNTPL9fO3rDrx8pYmVnj6nqceHNhnqceHNh
```

Response:

```
HTTP/1.1 200 OK
Content-Type: application/json
Cache-control: no-cache

[
  { "CountryName": "Abkhazia", "CountryCode": "AB", "Operator": "Default", "Network": "Default", "MCC": "289", "MNC": null, "Rate": "0.039" },
  { "CountryName": "Abkhazia", "CountryCode": "AB", "Operator": "Aquafon JSC", "Network": "Aquafon", "MCC": "289", "MNC": "67", "Rate": "0.039" }
]
```

## MCC / MNC list

```
GET https://api.vertexsms.com/mccmnc/{country}?Page={Page}
```

Input: `country` (ISO 3166-1 alpha-2), `Page` (int).

Returned fields: `country`, `mcc`, `mnc`, `operatorId`.

Request:

```
GET /mccmnc/LT?Page=1 HTTP/1.1
Host: api.vertexsms.com
Accept: application/json
X-VertexSMS-Token: eB52vNTPL9fO3rDrx8pYmVnj6nqceHNhnqceHNh
```

Response:

```
HTTP/1.1 200 OK
Content-Type: application/json
Cache-control: no-cache

[
  { "country": "LT", "MCC": "246", "MNC": "01", "operatorId": "1891" },
  { "country": "LT", "MCC": "246", "MNC": "02", "operatorId": "493" }
]
```

## Mobile prefix list

```
GET https://api.vertexsms.com/prefixes/{country}
```

Input: `country` (ISO 3166-1 alpha-2).

Returned fields: `prefix`, `country`, `operatorId`.

Request:

```
GET /prefixes/LT HTTP/1.1
Host: api.vertexsms.com
Accept: application/json
X-VertexSMS-Token: eB52vNTPL9fO3rDrx8pYmVnj6nqceHNhnqceHNh
```

Response:

```
HTTP/1.1 200 OK
Content-Type: application/json
Cache-control: no-cache

[
  { "prefix": "3706000", "country": "LT", "operatorId": "2536" },
  { "prefix": "3706001", "country": "LT", "operatorId": "2536" }
]
```

## Number correction

Validate and normalize a list of phone numbers.

```
GET https://api.vertexsms.com/numberCorrection
```

Input: an array of `{ Number, country }` objects. `country` is ISO 3166-1 alpha-2.

Returned per number: `Error` (description or null), `Number` (original), `NumberType` (`mobile`, `landline`, or `unknown`), `CountryIso`, `Mobile` (bool), `NumberE164` (corrected E.164 number).

Request:

```
POST /numberCorrection HTTP/1.1
Host: api.vertexsms.com
Content-Type: application/json
Accept: application/json
X-VertexSMS-Token: eB52vNTPL9fO3rDrx8pYmVnj6nqceHNhnqceHNh

[
  { "Number": "861860698", "CountryIso": "LT" },
  { "Number": "61860698", "CountryIso": "LT" },
  { "Number": "(370)-618-60698", "CountryIso": "LT" }
]
```

Response:

```
HTTP/1.1 200 OK
Content-Type: application/json
Cache-control: no-cache

[
  { "Error": null, "Number": "378611463155463", "NumberType": "unknown", "CountryIso": "LT", "Mobile": false, "NumberE164": "+370378611463155463" },
  { "Error": null, "Number": "61860698", "NumberType": "mobile", "CountryIso": "LT", "Mobile": true, "NumberE164": "+37061860698" },
  { "Error": null, "Number": "37056684554775", "NumberType": "unknown", "CountryIso": "LT", "Mobile": false, "NumberE164": "+37056684554775" }
]
```