How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Microsoft Azure Number API

The Number API from Microsoft Azure — 4 operation(s) for number.

Microsoft Azure Number API is one of 1667 APIs that Microsoft Azure publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Number. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, pricing, a JSON-LD context, and a getting-started guide.

This API exposes 8 operations across 4 paths, and defines 24 schemas. It is described by OpenAPI 3.2.0, at version 2020-08-01-preview.

8 operations 4 paths 24 schemas 2 DELETE4 GET2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2020-08-01-preview
Resource Areas
1

Paths & Operations 8

Across 4 paths, the API surfaces 8 operations — 2 DELETE, 4 GET, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Number 8
GET
/account/{accountName}/numbers
Microsoft Azure Get Account Accountname Numbers
microsoftAzureAccountListnumbers 4 params → 200default
DELETE
/account/{accountName}/numbers/{phoneNumber}
Microsoft Azure Delete Account Accountname Numbers Phonenumber
microsoftAzureNumberDelete 3 params → 204default
GET
/account/{accountName}/numbers/{phoneNumber}
Microsoft Azure Get Account Accountname Numbers Phonenumber
microsoftAzureNumberGet 3 params → 200default
PUT
/account/{accountName}/numbers/{phoneNumber}
Microsoft Azure Put Account Accountname Numbers Phonenumber
microsoftAzureNumberCreateorreplace 5 params body → 200201default
GET
/accounts/{accountName}/numbers
Microsoft Azure Get Numbers
microsoftAzureAccountsListnumbers 8 params → 200default
GET
/accounts/{accountName}/numbers/{telephoneNumber}
Microsoft Azure Get Number
microsoftAzureAccountsGetnumber 8 params → 200default
PUT
/accounts/{accountName}/numbers/{telephoneNumber}
Microsoft Azure Create Or Replace Number
microsoftAzureAccountsCreateorreplacenumber 10 params body → 200201default
DELETE
/accounts/{accountName}/numbers/{telephoneNumber}
Microsoft Azure Delete Number
microsoftAzureAccountsDeletenumber 10 params → 204default

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are TeamsPhoneMobileNumberConfig (9 properties), TeamsOperatorConnectNumberConfig (9 properties), NumberResource (6 properties), ErrorDetail (5 properties). Each schema is shown below with its type and property counts.

Azure.Core.Foundations.Error
object
The error object.
5 properties 2 required
NumberDetails
object
Details of the number.
2 properties 1 required
ZoomPhoneCloudPeeringNumberDetails
object
Details for the Zoom Phone Cloud Peering service on this Number.
1 property 1 required
TeamsOperatorConnectNumberDetails
object
Details for the Teams Operator Connect service on this Number.
3 properties 1 required
NumberConfiguration_2
object
Configuration for this number.
1 property
ServiceProvisioningStatus
string
The provisioning states of an object on any relevant backend service.
InnerError
object
2 properties
NumberResponse
object
Details of the number as returned on a GET request.
4 properties 3 required
TelephoneNumberAssignmentStatus
string
Indicates whether a number is assigned to a user.
TeamsPhoneMobileNumberDetails
object
Details for the Teams Phone Mobile service on this Number.
3 properties 1 required
NumberServices
object
Communications services enabled for this number.
3 properties 3 required
Azure.Core.Foundations.InnerError
object
An object containing more specific information about the error. As per Microsoft One API guidelines - https://github.com/Microsoft/api-guidelines/blob/vNext/Gu…
2 properties
TeamsOperatorConnectNumberConfig
object
Telephone number configuration for Teams Operator Connect telephone numbers.
9 properties 2 required
NumbersList
object
List of number records.
2 properties 1 required
TeamsPhoneMobileNumberConfig
object
Telephone number configuration for Teams Phone Mobile telephone numbers.
9 properties 2 required
NumberConfiguration
object
Configuration for this number.
1 property
PagedNumberResource
object
Paged collection of NumberResource items
2 properties 1 required
NumberServiceDetails
object
Configuration of backend services for a telephone number.
5 properties
Azure.Core.Foundations.ErrorResponse
object
A response containing error details.
1 property 1 required
TeamsDirectRoutingNumberDetails
object
Details for the Teams Direct Routing service on this Number.
1 property 1 required
ErrorResponse
object
Contains details when the response code indicates an error.
1 property 1 required
AzureOperatorCallProtectionNumberDetails
object
Details for the Azure Operator Call Protection service on this Number.
1 property 1 required
NumberResource
object
The configuration for a telephone number provisioned in Azure Communications Gateway.
6 properties 3 required
ErrorDetail
object
5 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

microsoft-azure-number-api-openapi.yml Raw ↑

Other APIs Microsoft Azure publishes across the network.

Microsoft Azure AI Search API
Microsoft Azure Communication Services API
Microsoft Azure Event Grid API
Microsoft Azure Functions API
Microsoft Azure DevOps REST API
Microsoft Azure AI Foundry API
Microsoft Azure Resource JSON Schema
Microsoft Azure JSON-LD Context
Microsoft Azure AccessConnector API
Microsoft Azure AccessControlRecords API
Microsoft Azure AccessPolicies API
Microsoft Azure AccessReviewInstanceAcceptRecommmendations API
Where this information came from

This is an independent, third-party profile of Microsoft Azure Number API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.