Skip to main content
POST
Searches available US Voice numbers for purchase. Each result includes a selectionToken that belongs to your account and expires after 10 minutes. The search can finish with no available selections. Requires voice_calls.write, the Voice Calls product entitlement, and an API key created by a current account owner. The search is a durable operation. Reuse the same requestId with the same body when retrying; a changed body for that ID returns 409 idempotency_conflict. A provider error can leave the operation in outcome_unknown. Repeat this POST with the same requestId and body to read or recover the search; the public operation-status GET supports acquisitions only.

Body Parameters

string
required
Stable retry identity: 1–128 printable ASCII characters without spaces.
integer
US area code from 200 to 999.
integer
default:20
Maximum candidates, from 1 to 20.

Response Fields

string
The durable search operation ID.
string
The operation status. complete means result.selections is ready.
string | null
A failure code, when present.
array
Available numbers when the search completes. Each entry has selectionToken, e164, and expiresAt.

Example

Error Codes