Answers 200 with nulls when the operator cannot be identified: the lookup succeeded and found nothing. A failing lookup answers 502 instead, so the two are distinguishable.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Phone Number Format
The phone field accepts a subscriber phone number in international or national format. Formatting characters — spaces, hyphens, brackets, and dots — are stripped automatically, so +7 (910) 561-55-67 and +79105615567 are treated identically.
How the number is interpreted depends on whether it starts with a plus sign:
phone | countryIsoCode | Result |
|---|---|---|
+79105615567 | Optional, ignored | Accepted. The country is derived from the dial code. |
79105615567 | RU | Accepted as an international number. |
89105615567 | RU | Accepted. The trunk prefix 8 is replaced with the dial code. |
9105615567 | RU | Accepted as a national number. |
9105615567, 89105615567 | Not provided | Rejected with 400 VALIDATION_ERROR. |
A number starting with + is self-contained and never requires countryIsoCode. A number without + is ambiguous, so countryIsoCode is required to interpret it — this endpoint applies no default country. If you collect numbers in a national format, always pass countryIsoCode along with the phone number.
In the response, phoneNumber is returned normalized to E.164 (for example, +79105615567), and countryIsoCode is derived from the number itself, not echoed from the request.
The mobile operator can be determined for Russian numbers only. A valid number from any other country passes validation and returns 200 OK with "mobileOperator": null.