Share via

Phone Numbers - Get Operation

Service:
Communication
API Version:
2025-06-01

Gets an operation by its id.

GET {endpoint}/phoneNumbers/operations/{operationId}?api-version=2025-06-01

URI Parameters

Name In Required Type Description
endpoint
 path True

string (url)

The communication resource, for example https://resourcename.communication.azure.com
operationId
 path True

string

The id of the operation
api-version
 query True

string

Version of API to invoke

Responses

Name Type Description
200 OK

PhoneNumberOperation

When the operation is completed, query the final result of the operation using the URL specified in the 'Location' attribute in the response header.

Headers

Location: string
Other Status Codes

CommunicationErrorResponse

Failure

Examples

Get long running operation status by operation id

Sample request

GET https://resourcename.communication.azure.com//phoneNumbers/operations/search-my-operation-id?api-version=2025-06-01

Sample response

Status code:
200 
Location: /availablePhoneNumbers/searchResults/378ddf60-81be-452a-ba4f-613198ea6c28
{
  "status": "succeeded",
  "resourceLocation": "/availablePhoneNumbers/searchResults/378ddf60-81be-452a-ba4f-613198ea6c28",
  "createdDateTime": "2020-11-19T16:31:49.048Z",
  "id": "search-my-operation-id",
  "operationType": "search",
  "lastActionDateTime": "2020-11-19T22:31:49.048Z"
}

Definitions

Name Description
CommunicationError

The Communication Services error.
CommunicationErrorResponse

The Communication Services error.
PhoneNumberOperation
PhoneNumberOperationStatus

Status of operation.
PhoneNumberOperationType

The type of operation, e.g. Search

CommunicationError

Object

The Communication Services error.

Name Type Description
code

string

The error code.
details

CommunicationError[]

Further details about specific errors that led to this error.
innererror

CommunicationError

The inner error if any.
message

string

The error message.
target

string

The error target.

CommunicationErrorResponse

Object

The Communication Services error.

Name Type Description
error

CommunicationError

The Communication Services error.

PhoneNumberOperation

Object
Name Type Description
createdDateTime

string (date-time)

The date that the operation was created.
error

CommunicationError

The Communication Services error.
id

string

Id of operation.
lastActionDateTime

string (date-time)

The most recent date that the operation was changed.
operationType

PhoneNumberOperationType

The type of operation, e.g. Search
resourceLocation

string

URL for retrieving the result of the operation, if any.
status

PhoneNumberOperationStatus

Status of operation.

PhoneNumberOperationStatus

Enumeration

Status of operation.

Value Description
notStarted
running
succeeded
failed

PhoneNumberOperationType

Enumeration

The type of operation, e.g. Search

Value Description
purchase
releasePhoneNumber
search
updatePhoneNumberCapabilities
reservationPurchase