Phone Numbers
Search Plivo Numbers
Search available phone numbers from Plivo.
GET
Search Plivo Numbers
Read only
Searches Plivo’s inventory of phone numbers that are available for purchase. This is the discovery step before buying: find a number in the country and pattern you want, then pass it to Buy Phone Number.
Recommended. This endpoint is part of the public
/v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.When to use this
- Provisioning a new line: find an available number in the destination country before purchasing it for inbound or outbound calling.
- Self-serve number pickers: let users of your own product browse available numbers before you buy one on their behalf.
Result
The response lists candidate numbers from Plivo’s inventory with their attributes; use the response schema on this page for the exact fields. Availability is live inventory and can change between searching and buying, so purchase promptly after picking a number. See Errors for the standard error format.Related endpoints
- Buy Phone Number: purchase a number found here.
- List Phone Numbers: the numbers your workspace already owns.
- Link SIP Trunk: bring your own number instead.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
ISO country code (e.g., US, GB, CA)
Example:
"US"
Type of number (e.g., tollfree, local, mobile)
Example:
"tollfree"
Search Plivo Numbers