---
title: "Searches for number format and operator information for a given list of phone numbers."
method: POST
path: "/operatorInformation/:search"
tags: ["Obtain operator information for requested numbers"]
---

# Searches for number format and operator information for a given list of phone numbers.

`POST /operatorInformation/:search`

## Query parameters

- `api-version` string, required

## Request body

- OperatorInformationRequest — Represents a search request for operator information for the given phone numbers.
  - `phoneNumbers` string[], required — Phone number(s) whose operator information is being requested
  - `options` OperatorInformationOptions — Represents options to modify a search request for operator information
    - `includeAdditionalOperatorDetails` boolean — Includes the fields operatorDetails, numberType, and isoCountryCode in the response. Please note: use of this option will result in additional costs

## Response `200`

Success

- OperatorInformationResult — Represents a search result containing format and operator information associated with the requested phone numbers
  - `values` OperatorInformation[] — Results of a search. This array will have one entry per requested phone number which will contain the relevant operator information.
    - `phoneNumber` string, required — E.164 formatted string representation of the phone number
    - `nationalFormat` string — National format of the phone number
    - `internationalFormat` string — International format of the phone number
    - `isoCountryCode` string — ISO 3166-1 two character ('alpha-2') code associated with the phone number.
    - `numberType` 'unknown' | 'other' | 'geographic' | 'mobile' — Type of service associated with the phone number
    - `operatorDetails` OperatorDetails — Represents metadata describing the operator of a phone number
      - `name` string — Name of the phone operator
      - `mobileNetworkCode` string — Mobile Network Code, 2 or 3 decimal digits that identify mobile networks within a country/region
      - `mobileCountryCode` string — Mobile Country Code, 3 decimal digits that identify a country/region

## Other responses

- `default` — Failure

## Changes

- **2026-07-13** (2021-03-07) `6cb38fd8046e` — 1 info
  - endpoint added
- **2021-05-19** (2021-03-07) `5c6abf2b2252` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/communication-phonenumbers/changes/operatorInformation/:search/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-phonenumbers.md) · [All operations](https://skmtc.dev/azure/apis/communication-phonenumbers/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-phonenumbers/revisions/6e81b3741aa7/schema)