Go back to dialerseat.comsales@dialerseat.com
Voice

Voice: numbers, porting and 911

Search, hold, buy, manage and release US numbers; port your own in; give them an emergency address.


DialerSeat Voice works in the sandbox today: call it with your test key, or open Voice & SIP in the console. Live numbers and calls open by request: email dev@dialerseat.com.

Number types

  • Local: A number in a US area code, for calling and caller ID people recognize.
  • Toll-free: 800, 833, 844, 855, 866, 877 and 888 numbers, free for the caller.
  • GET /v1/voice/available_phone_numbers: US local and toll-free numbers you can buy now, by area code, state, rate center, city, or digits the number starts with, contains or ends with. Each comes with its region and its monthly and one-time cost.
  • POST /v1/voice/number_reservations: Hold up to 100 numbers from a search for 30 minutes while you decide, so nobody else buys them.
  • POST /v1/voice/number_orders: Buy up to 100 numbers in one order, assigned straight to a SIP connection or a voice application. Paid from your balance; number_order.completed arrives when they can take calls.
  • GET /v1/voice/number_orders/{id}: An order's status (pending, completed, failed) and each number in it.
Ten numbers in Austin
curl "https://api.dialerseat.com/v1/voice/available_phone_numbers?area_code=512&number_type=local&limit=10" \
  -H "Authorization: Bearer dsk_live_..."

Search by area_code, state, rate_center, locality, starts_with, contains or ends_with, and number_type (local or toll_free). Numbers you order can go straight onto a SIP connection or a voice application, so they take calls the moment number_order.completed arrives.

Your numbers

  • GET /v1/voice/phone_numbers: Every number you own, with its connection or application, tags, emergency address and status. Filter by tag, state, area code or connection.
  • PATCH /v1/voice/phone_numbers/{id}: Move it to another connection or application, change its tags, or set how inbound calls are handled: forwarding, recording, and a fallback when your application does not answer.
  • POST /v1/voice/phone_numbers/bulk_update: Move or retag up to 1,000 numbers in one request, for re-pointing a whole pool at a new connection.
  • DELETE /v1/voice/phone_numbers/{id}: Give the number up. It stops ringing at once and its monthly charge stops at the end of the day.

Bringing your numbers

Check first, then start a port with the account details your current carrier holds: the account number, the PIN if it has one, the authorized name and the service address, plus a recent bill and a signed letter of authorization. A port is a draft until you submit it; porting_order.status_changed tells you each step, and an exception names what the losing carrier rejected so you can fix it and carry on.

  • POST /v1/voice/portability_checks: Before you start, find out whether each number can come to DialerSeat Voice and from which carrier.
  • POST /v1/voice/porting_orders: Bring numbers you own elsewhere, with the account details and authorized name the losing carrier needs. Draft until you submit it.
  • POST /v1/voice/porting_orders/{id}/documents: Upload the latest bill and letter of authorization a port needs.
  • POST /v1/voice/porting_orders/{id}/actions/submit: Send it to the losing carrier. porting_order.status_changed arrives at every step.
  • POST /v1/voice/porting_orders/{id}/actions/cancel: Stop a port that has not completed.

911

A number that takes inbound calls needs a registered street address before a 911 call from it can reach the right dispatch center with that address. Add the address once and attach it to as many numbers as share it.

  • POST /v1/voice/emergency_addresses: A validated street address for 911. Every number that takes inbound calls needs one before emergency calling works.
  • POST /v1/voice/phone_numbers/{id}/actions/enable_emergency: Tie a number to an emergency address so a 911 call from it reaches the right dispatch center with that address.

Related:DialerSeat Voice: numbers, SIP and a voice API, Voice: SIP trunking, Voice: the Voice API and Voice: answering-machine detection.