# Azure Communication Services Phone Numbers API **Canonical:** https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-phonenumbers-api/ **Provider:** Microsoft Azure Communication Services — https://apis.io/providers/microsoft-azure-communication-services/ **Base URL:** https://{resource}.communication.azure.com/ **Documentation:** https://learn.microsoft.com/en-us/rest/api/communication/ Azure Communication Services Phone Numbers API is one of 10 APIs that [Microsoft Azure Communication Services](https://apis.io/providers/microsoft-azure-communication-services/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Phone Numbers and Telephony. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas. Phone Numbers API: search, purchase, update capabilities of and release telephone numbers. 20 operations, data-plane version 2025-06-01, served from the customer's Communication Services resource endpoint. ## Operations (20) | Method | Path | Summary | |---|---|---| | GET | `/availablePhoneNumbers/countries/{countryCode}/areaCodes` | Gets the list of available area codes. | | GET | `/availablePhoneNumbers/countries` | Gets the list of supported countries. | | POST | `/availablePhoneNumbers/countries/{countryCode}/:browse` | Browses for available phone numbers to purchase. | | GET | `/availablePhoneNumbers/countries/{countryCode}/localities` | Gets the list of cities or towns with available phone numbers. | | GET | `/availablePhoneNumbers/countries/{countryCode}/offerings` | List available offerings of capabilities with rates for the given country. | | GET | `/availablePhoneNumbers/reservations` | Lists all reservations. | | PATCH | `/availablePhoneNumbers/reservations/{reservationId}` | Creates or updates a reservation by its ID. | | GET | `/availablePhoneNumbers/reservations/{reservationId}` | Gets a reservation by its ID. | | DELETE | `/availablePhoneNumbers/reservations/{reservationId}` | Deletes a reservation by its ID. | | POST | `/availablePhoneNumbers/reservations/{reservationId}/:purchase` | Starts the purchase of all phone numbers in the reservation. | | POST | `/availablePhoneNumbers/countries/{countryCode}/:search` | Search for available phone numbers to purchase. | | GET | `/availablePhoneNumbers/searchResults/{searchId}` | Gets a phone number search result by search id. | | POST | `/availablePhoneNumbers/:purchase` | Purchases phone numbers. | | GET | `/phoneNumbers/operations/{operationId}` | Gets an operation by its id. | | DELETE | `/phoneNumbers/operations/{operationId}` | Cancels an operation by its id. | | PATCH | `/phoneNumbers/{phoneNumber}/capabilities` | Updates the capabilities of a phone number. | | GET | `/phoneNumbers/{phoneNumber}` | Gets the details of the given purchased phone number. | | DELETE | `/phoneNumbers/{phoneNumber}` | Releases a purchased phone number. | | GET | `/phoneNumbers` | Gets the list of all purchased phone numbers. | | POST | `/operatorInformation/:search` | Searches for number format and operator information for a given list of phone numbers. | ## Machine-readable artifacts (9) - **OpenAPI** — https://artifacts.apis.io/microsoft-azure-communication-services/openapi/microsoft-azure-communication-services-phonenumbers-api-openapi.yml - **OpenAPI** — https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/communication/data-plane/PhoneNumbers/stable/2025-06-01/phonenumbers.json - **Documentation** — https://learn.microsoft.com/en-us/azure/communication-services/ - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-phone-number-search-result-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-phone-numbers-reservation-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-purchased-phone-number-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-phone-number-search-request-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-phone-number-operation-schema.json - **JSONSchema** — https://artifacts.apis.io/microsoft-azure-communication-services/json-schema/microsoft-azure-communication-services-phone-numbers-browse-request-schema.json ## Other Microsoft Azure Communication Services APIs (9) - [Azure Communication Services Call Automation API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-callautomation-api/) - [Azure Communication Services Chat API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-chat-api/) - [Azure Communication Services Email API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-email-api/) - [Azure Communication Services Identity API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-identity-api/) - [Azure Communication Services Job Router API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-jobrouter-api/) - [Azure Communication Services Advanced Messaging API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-messages-api/) - [Azure Communication Services Rooms API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-rooms-api/) - [Azure Communication Services SIP Routing API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-siprouting-api/) - [Azure Communication Services SMS API](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-sms-api/) ## Tags Phone Numbers, Telephony --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-azure-communication-services/microsoft-azure-communication-services-phonenumbers-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-azure-communication-services/.