Number Status

The Number Status request validates the status of the uploaded numbers.

URL

Copy 
{{baseUrl}}/api/v2/oc/numbers/action/number-status

HTTP Method

POST

Request Body

Parameter

Type

Description

telephoneNumbers

string list

List of phone numbers that are uploaded to the customer.

Phone number validation rules are in accordance with E.164 format:

■ A + sign.
■ Country calling code (international).
■ Local area code.

Local telephone number or subscriber number.

It has the following structure: [+][country code][area code][subscriber number].

Example of a number with E.164 format in the United States

Telephone number: 415 123 1234

E.164 format number: +14151231234

■ Country code: +1
■ Area code: 415
■ Subscriber number: 1231234

Valid country code, per civic address and/or contact info of the given lead. See Country Dialing Codes.

 

msTenantId

string

Microsoft Tenant ID of customer tenant for validation.

Example Request-Single Number

Copy 
     {
  "telephoneNumbers": [
    "+18333998785"
  ],
  "msTenantId": "f94238e5-4f2c-4e1b-8125-2d27122ca75f"
}

 

HTTP Responses

■ 200 OK

Parameter

Type

Description

validationResult

string

Indicates if the validation execution is successful.

■ Success: The number is successfully validated.
■ Failure: The number cannot be validated. This response also reflects scenarios where the number is currently being processed (the number is still in cache memory due to Upload or Release action).

telephoneNumbers

list array

List array including the following values:

telephoneNumber; validationResult, actionRequired, validationDetail, telephoneNumberDetail: numberFound, numberOffering and assignmentStatus

telephoneNumber

string

Indicates the telephone number that was validated.

validationResult

string

Indicates if the validation execution succeeded or failed.

actionRequired

string

Indicates if any actions are required.

validationDetail

list array

List array including the following values:

■ Level
■ Description

Level

string

Error or Information message

Description

string

Description of the message (see examples below)

telephoneNumberDetail

list array

list array including the following values:

■ numberFound
■ numberOffering
■ assignmentStatus

numberFound

boolean

Indicates whether the number is found in the Customer inventory in the Live Platform database.

■ True: The number is found in the Customer inventory. This response also reflects scenarios where the number is currently being processed (is in cache memory due to Upload or Release of number).
■ False: The number is

numberOffering

string

One of the following values:

■ Operator Connect
■ Direct Routing
■ Microsoft Calling Plan

assignmentStatus

boolean

Indicates whether the number has been assigned to the subscriber user in their Teams admin center.