curl https://api.tracklysms.com/api/v1/voice/number-acquisitions/665f1e2a9c4b1a0012ab34cd \
-H "X-Api-Key: trk_your_api_key_here"
{
"id": "<string>",
"action": "<string>",
"status": "<string>",
"errorCode": {},
"result": {},
"createdAt": "<string>",
"submittedAt": {},
"completedAt": {}
}Voice Calls (v1)
Get a Number Acquisition
Read the durable status of a Voice number purchase.
GET
/
v1
/
voice
/
number-acquisitions
/
{operationId}
curl https://api.tracklysms.com/api/v1/voice/number-acquisitions/665f1e2a9c4b1a0012ab34cd \
-H "X-Api-Key: trk_your_api_key_here"
{
"id": "<string>",
"action": "<string>",
"status": "<string>",
"errorCode": {},
"result": {},
"createdAt": "<string>",
"submittedAt": {},
"completedAt": {}
}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
Response Fields
The retained result. It can contain a number ID before the operation is complete; rely on
status to confirm acquisition.Example
curl https://api.tracklysms.com/api/v1/voice/number-acquisitions/665f1e2a9c4b1a0012ab34cd \
-H "X-Api-Key: trk_your_api_key_here"
Error Codes
| Status | Code | Meaning |
|---|---|---|
| 403 | owner_required | The key’s creator is not a current account owner. |
| 404 | resource_not_found | This account has no acquisition with that ID. |