Get Operator Connect Customer Numbers V3

The Get Operator Connect Customer Numbers V3 request retrieves the numbers that have been acquired through the Operator Connect service for the specified tenant. Each number includes detailed information about its current status, capabilities, location assignments, and associated SBC configurations.

URI

Copy 
{{baseUrl}}/api/v3/oc/numbers?

HTTP Method

GET

Request Parameters

Parameter

Type

Description

msTenantId

string

Customer's Microsoft Azure Tenant Subscription Id.

acquiredNumberStatus

string

Status of the acquired number:

■ Active
■ Release Requested
■ Marked For Removal
■ Ready For Removal

Page Number

integer

Default value: 1

Page number in range to retrieve.

Page Size

integer

Default value: 200

Number of pages in range to retrieve.

Request Body

Parameter

Type

Description

X-Ovoc-Channel-Id

integer channel identifier

Filter access to customers belonging to the specified channel. See Get List of Channels to retrieve channel Ids.

Example Response

Copy 

          {
    "currentPage": 1,
    "pageSize": 10,
    "totalPages": 1,
    "totalRecords": 10,
    "data": [
        {
            "uploadTelephoneNumberEntryId": 294672,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121452,
            "uploadToAccountJobId": 4977,
            "whenCreated": "2026-02-16T16:17:56.1427926+00:00",
            "acquiredNumberStatus": 0,
            "telephoneNumber": "+448718943000",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "Geographic",
                "Office365",
                "InboundCalling",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": [
                "Geographic",
                "FirstPartyAppAssignment",
                "Office365",
                "InboundCalling",
                "OutboundCalling",
                "UserAssignment",
                "SharedCalling"
            ],
            "acquiredOn": "2026-02-16T16:17:41.0518562+00:00",
            "isoCountryCode": "GB",
            "tnUploadJobId": "1d3d24fd-3d2d-4b26-b964-ebb8558c1091",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": "Unassigned",
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": "2026-02-17T09:52:59.6920174+00:00",
            "aslsct": "2026-02-17T09:52:59.6920174+00:00",
            "aslvCode": 200,
            "asticks": 639069187671521345
        },
        {
            "uploadTelephoneNumberEntryId": 294673,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121453,
            "uploadToAccountJobId": 4977,
            "whenCreated": "2026-02-16T16:17:56.1427926+00:00",
            "acquiredNumberStatus": 0,
            "telephoneNumber": "+448718943001",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "Geographic",
                "Office365",
                "InboundCalling",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": [
                "Geographic",
                "FirstPartyAppAssignment",
                "Office365",
                "InboundCalling",
                "OutboundCalling",
                "UserAssignment",
                "SharedCalling"
            ],
            "acquiredOn": "2026-02-16T16:17:41.0518868+00:00",
            "isoCountryCode": "GB",
            "tnUploadJobId": "1d3d24fd-3d2d-4b26-b964-ebb8558c1091",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": "Unassigned",
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": "2026-02-17T09:52:59.7470197+00:00",
            "aslsct": "2026-02-17T09:52:59.7470197+00:00",
            "aslvCode": 200,
            "asticks": 639069187671521345
        },
        {
            "uploadTelephoneNumberEntryId": 294676,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121456,
            "uploadToAccountJobId": 4980,
            "whenCreated": "2026-02-17T10:18:16.2101833+00:00",
            "acquiredNumberStatus": 4,
            "telephoneNumber": "+448718943002",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "InboundCalling",
                "Office365",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": null,
            "acquiredOn": null,
            "isoCountryCode": "GB",
            "tnUploadJobId": "4bc846cb-0f7a-434f-a6ec-2f552b0bf068",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": null,
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": null,
            "aslsct": null,
            "aslvCode": null,
            "asticks": null
        },
        {
            "uploadTelephoneNumberEntryId": 294677,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121457,
            "uploadToAccountJobId": 4980,
            "whenCreated": "2026-02-17T10:18:16.2101833+00:00",
            "acquiredNumberStatus": 4,
            "telephoneNumber": "+448718943003",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "InboundCalling",
                "Office365",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": null,
            "acquiredOn": null,
            "isoCountryCode": "GB",
            "tnUploadJobId": "4bc846cb-0f7a-434f-a6ec-2f552b0bf068",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": null,
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": null,
            "aslsct": null,
            "aslvCode": null,
            "asticks": null
        },
        {
            "uploadTelephoneNumberEntryId": 294678,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121458,
            "uploadToAccountJobId": 4980,
            "whenCreated": "2026-02-17T10:18:16.2101833+00:00",
            "acquiredNumberStatus": 4,
            "telephoneNumber": "+448718943004",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "InboundCalling",
                "Office365",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": null,
            "acquiredOn": null,
            "isoCountryCode": "GB",
            "tnUploadJobId": "4bc846cb-0f7a-434f-a6ec-2f552b0bf068",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": null,
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": null,
            "aslsct": null,
            "aslvCode": null,
            "asticks": null
        },
        {
            "uploadTelephoneNumberEntryId": 294679,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121459,
            "uploadToAccountJobId": 4980,
            "whenCreated": "2026-02-17T10:18:16.2101833+00:00",
            "acquiredNumberStatus": 4,
            "telephoneNumber": "+448718943005",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "InboundCalling",
                "Office365",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": null,
            "acquiredOn": null,
            "isoCountryCode": "GB",
            "tnUploadJobId": "4bc846cb-0f7a-434f-a6ec-2f552b0bf068",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": null,
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": null,
            "aslsct": null,
            "aslvCode": null,
            "asticks": null
        },
        {
            "uploadTelephoneNumberEntryId": 294680,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121460,
            "uploadToAccountJobId": 4980,
            "whenCreated": "2026-02-17T10:18:16.2101833+00:00",
            "acquiredNumberStatus": 4,
            "telephoneNumber": "+448718943006",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "InboundCalling",
                "Office365",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": null,
            "acquiredOn": null,
            "isoCountryCode": "GB",
            "tnUploadJobId": "4bc846cb-0f7a-434f-a6ec-2f552b0bf068",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": null,
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": null,
            "aslsct": null,
            "aslvCode": null,
            "asticks": null
        },
        {
            "uploadTelephoneNumberEntryId": 294681,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121461,
            "uploadToAccountJobId": 4980,
            "whenCreated": "2026-02-17T10:18:16.2101833+00:00",
            "acquiredNumberStatus": 4,
            "telephoneNumber": "+448718943007",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "InboundCalling",
                "Office365",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": null,
            "acquiredOn": null,
            "isoCountryCode": "GB",
            "tnUploadJobId": "4bc846cb-0f7a-434f-a6ec-2f552b0bf068",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": null,
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": null,
            "aslsct": null,
            "aslvCode": null,
            "asticks": null
        },
        {
            "uploadTelephoneNumberEntryId": 294682,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121462,
            "uploadToAccountJobId": 4980,
            "whenCreated": "2026-02-17T10:18:16.2101833+00:00",
            "acquiredNumberStatus": 4,
            "telephoneNumber": "+448718943008",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "InboundCalling",
                "Office365",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": null,
            "acquiredOn": null,
            "isoCountryCode": "GB",
            "tnUploadJobId": "4bc846cb-0f7a-434f-a6ec-2f552b0bf068",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": null,
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": null,
            "aslsct": null,
            "aslvCode": null,
            "asticks": null
        },
        {
            "uploadTelephoneNumberEntryId": 294683,
            "source": "webapi",
            "sbcList": [
                {
                    "sbcName": "US SP1 SBC",
                    "sbcId": 11
                }
            ],
            "tenantCallingProfileId": null,
            "ocSipConnectionName": null,
            "ocSipConnectionDescription": null,
            "umpCustomerGuid": "82686da4-980d-4eef-8c00-cfe918d954d4",
            "sbcListJson": null,
            "ovocChannelId": 0,
            "consentedOn": null,
            "umpCustomerFullName": "BradOCDev",
            "msCompanyName": "MSFT",
            "sbcListArray": [],
            "id": 121463,
            "uploadToAccountJobId": 4980,
            "whenCreated": "2026-02-17T10:18:16.2101833+00:00",
            "acquiredNumberStatus": 4,
            "telephoneNumber": "+448718943009",
            "callingProfileId": "ab86ef82-ce9e-4ead-befb-4aa954b64872",
            "acquiredCapabilities": [
                "InboundCalling",
                "Office365",
                "OutboundCalling",
                "UserAssignment"
            ],
            "availableCapabilities": null,
            "acquiredOn": null,
            "isoCountryCode": "GB",
            "tnUploadJobId": "4bc846cb-0f7a-434f-a6ec-2f552b0bf068",
            "locationId": null,
            "civicAddressId": null,
            "assignmentStatus": null,
            "tenantId": "3bc57cac-5794-457f-ad36-2c88cade9dbb",
            "aslcht": null,
            "aslsct": null,
            "aslvCode": null,
            "asticks": null
        }
    ]
}

HTTP Responses

■ 200 OK

Parameter

Type

Description

current Page

integer

Default value: 1

Retrieves the current page (the page including the most recent entries).

Page Number

integer

Default value: 1

Page number in range to retrieve.

Page Size

integer

Default value: 200

Number of pages in range to retrieve.

Data (acquired number details)

list array

List array including the following:

■ uploadTelephoneNumberEntryId
■ uploadToAccountJobId
■ whenCreated
■ acquiredNumberStatus AcquiredNumberStatus
■ telephoneNumber
■ callingProfileId
■ acquiredCapabilities
■ availableCapabilities
■ acquiredOn
■ isoCountryCode
■ tnUploadJobId
■ locationId
■ civicAddressId
■ assignmentStatus
■ tenantId
■ aslcht
■ aslsct
■ aslvCode
■ asticks
■ uploadTelephoneNumberEntryId
■ source
■ sbcList
■ tenantCallingProfileId
■ ocSipConnectionName
■ ocSipConnectionDescription
■ umpCustomerGuid
■ sbcListJson
■ ovocChannelId
■ consentedOn
■ umpCustomerFullName
■ msCompanyName
■ sbcListArray

uploadTelephoneNumberEntryId

string

Unique identifier of the uploaded number.

source

string

Source interface of the uploaded number; webapi

sbcList

list array

List array including the following parameters:

■ sbcName
■ sbcId

sbcName

string

Name of the SBC device in the Live Platform SQL database.

sbcId

integer

Id of the SBC device that is attached to the tenant service for number management in Live Platform SQL database.

tenantCallingProfileId

integer

The Id of the Calling Profile Template record that is attached to the tenant service. A new record is created each time the template is attached to a customer service. Calling Profile Provisioning templates allow you to apply Calling Profile Templates when applying license (see Create OC Essential Service from Lead with IP Group), adding OC SIP Connections (see Add SIP Connections), uploading numbers (see Upload Operator Connect Numbers to Customer) and releasing numbers (see Release Operator Connect Numbers from Customer). You can then assign each Calling Profile Provisioning template to a different IP Group. For instance, you might want to configure an IP Group with enhanced security settings based on the site location's topology requirements and map it to a Calling Profile tailored for a specific carrier.

This value is assigned to services with IP Group-based SIP Connections; this method is currently not supported using the REST API.

ocSipConnectionName

string

 The name of the OC SIP Connection (for services with SIP Connection type "IP Group").

This value is assigned to services with IP Group-based SIP Connections; this method is currently not supported using the REST API.

ocSipConnectionDescription

string

Short description of the OC SIP Connection.

This value is assigned to services with IP Group-based SIP Connections; this method is currently not supported using the REST API.

umpCustomerGuid

string($guid)

This value is created in the Live Platform customer tenant SQL database directory when a license is applied to the lead Create Service from Lead Overview).

This value is also obtained in the 'Get Task' response when the customer service is created.

ovocChannelId

integer

The Id of the Live Platform channel if the service is attached to a channel.

consentedOn

string($date-time

The date of consent by the Operator.

umpCustomerFullName

string

Full customer name

msCompanyName

string

MSFT

sbcListArray

string

id

integer

.

uploadToAccountJobId

integer

Job Id indicating when the number was uploaded.

whenCreated

string($date-time)

Timestamp indicating when the number was uploaded to Live Platform.

acquiredNumberStatus

integer
■ Active: 0 Number is active and synchronized with Microsoft Teams admin center.
■ ReleaseRequested: 1 Numbers that you have deleted directly in Live Platform.
■ MarkedForRemoval: 2 Numbers that have been deleted by Teams admin center and your approval is needed for deletion.
■ ReadyForRemoval:3 Numbers that have been removed by Teams admin center and approved for deletion by Live Platform. This status ends when the number is removed from Live Platform database. The previous status is MarkedForRemoval.
■ PendingFirstSync: 4 Numbers (when first added) that still haven't being synchronized with Microsoft Teams admin center.
■ All: No filter.

telephoneNumber

string

Uploaded Telephone number. A separate record set is retrieved for each phone number.

callingProfileId

string

The Id string for the Microsoft Operator Connect Calling Profile that is attached to the tenant service (see Get Calling Profiles). Each Calling Profile is mapped to an SBC trunk used to manage call functionality for tenant service.

acquiredCapabilities

string

Capabilities acquired from the Calling profile. One of the following values:

■ Inbound Calling with the following matching supported usages:
✔ CallingUserAssignment
✔ FirstPartyAppAssignment
✔ Conference Assignment
■ Outbound Calling with the following matching supported usages:
✔ CallingUserAssignment
✔ FirstPartyAppAssignment
✔ Conference Assignment
■ OC Mobile with the following matching supported usages:
✔ CallingUserAssignment
■ Mobile with the following matching supported usages:
✔ CallingUserAssignment
✔ FirstPartyAppAssignment

availableCapabilities

string

Capabilities available for configuration in the Calling profile:

■ Geographic
■ FirstPartyAppAssignment
■ Office365
■ InboundCalling
■ OutboundCalling
■ UserAssignment
■ SharedCalling

acquiredOn

string($date-time)

Timestamp indicating when the number was uploaded to customer tenant.

isoCountryCode

string

Country Calling dial code configured by customer in Teams admin center. See Country Dialing Codes for a full list of Dialing codes.

tnUploadJobId

string

Job Id for upload to customer account.

locationId

string

Id of the site location (see Get Services Brief Details (V3).

civicAddressId

string

Id of the civicAddress (see Get All OC Leads).

assignmentStatus

list array

Indicates the type of number assignment in the Teams admin center:

■ UserAssigned: Assign number directly to a user.
■ ConferenceAssigned: Assign Service number to an Audio conferencing bridge.
■ VoiceApp: Assign Service number to an Auto attendant or Call queue.
■ ThirdPartyAppAssigned

tenantId

string

Customer tenant Azure subscription tenant Id.

aslcht

string($date-time)

Last successful assignment check time, updated each time after a successful verification.

If there are errors, do not update this field, and do not touch the status itself.

aslsct

string($date-time)

Last status change time (null if not known).

alsvcode

string

Last verification code, numeric, inspired from http status codes:

■ 200 OK
■ 500, 404
■ Set to null in case of never verified

asticks

string($date-time)

Ticks for the iteration session.
■ 404 Not Found

The table below shows the full list of fields returned in this response. The actual fields returned may differ according to the request.

Parameter

Type

Description

type

string

Error type

title

string

Email title

status

integer

StatusCodes.Status400BadRequest

detail

string

Additional error details.

instance

string

HttpContext.Request.Path

errorTicket

string

errId.ToString()

errorCode

string

Error code output in the request

traceId

string

HttpContext.TraceIdentifier

additionalProp1

string

TBD

additionalProp2

string

TBD

additionalProp3

string

TBD
■ 500 Internal Server Error

See relevant fields above