Numbers Status
Check the current status of one or more phone numbers including provisioning state, active services, and any pending changes or issues.
What this does: Returns the status result for each number in the batch. Use action codes such as Cancel, Park, Swap, Replace, Swap-Sim, or Activate to change number lifecycle state. Each result includes the number, the action taken, and success or error status.
Next steps:
- Confirm new number state —
GET /v1.0/numbers - View inventory —
GET /v1.0/numbers/inventory
Body
Type of status change to perform
activate, cancel, swap, swap-sim, replace, park "replace"
Date when status change takes effect (MM/DD/YYYY)
"12/31/2023"
Array of phone numbers to update
Area code for swap/replace (searched first)
"201"
Zip code for swap/replace (if area code unavailable)
"84043"
Response
Numbers Activate
The response is of type object.