Search and Buy a Number
A 3-step recipe with Twilio. We can help you get access.
Recipe · 3 steps
Search and Buy a Number
with Twilio · Telecom Subscriber Management
Search hosted number orders, provision a number, and confirm the order.
- Discover existing HostedNumberOrders by capability and status so you can see in-flight numbers and pick candidates before provisioning.
- Provision the number by creating a HostedNumberOrder that hosts its capabilities on Twilio's platform, producing an IncomingPhoneNumber SID.
- Fetch the HostedNumberOrder back to confirm it was created and read its current status.
What you'll need to have ready
- smsCapability: Filter discovery to orders that host the SMS capability.
- status: HostedNumberOrder status to filter the discovery search on. One of received, pending-verification, verified, pending-loa, carrier-processing, testing, completed
- phoneNumber: The number to host, in +E.164 format (e.g. a Twilio test number).
- contactPhoneNumber: Contact phone number of the person authorized to sign the LOA.
- addressSid: Address SID (starts with AD) for the owner of the number.
- email: Email of the owner of the number being hosted.
- friendlyName: Human readable description for the order, up to 128 characters.
For your developer
Arazzo workflow twilio:search-and-buy-number, 3 operations: ListHostedNumberOrder → CreateHostedNumberOrder → FetchHostedNumberOrder. Specs on APIs.io.