Skip to main content
GET
Reads a Voice number acquisition in the authenticated account. Requires voice_calls.read, the Voice Calls product entitlement, and an API key created by a current account owner. Other setup operations and operations from other accounts return 404. Read this endpoint after acquiring a number, particularly when the initial response was lost or its status was outcome_unknown. complete confirms the purchase result. A pending or unknown status does not confirm ownership; use the operation ID to continue reading.

Path Parameters

string
required
Acquisition operation ID from the 202 response or its Location header.

Response Fields

string
The acquisition operation ID.
string
Always number_acquisition.
string
The current durable status.
string | null
A failure code, when present.
object
The retained result. It can contain a number ID before the operation is complete; rely on status to confirm acquisition.
string
Operation creation time.
string | null
Provider submission time, when present.
string | null
Completion time, when present.

Example

Error Codes