Voice: API reference
Every DialerSeat Voice endpoint, grouped, at https://api.dialerseat.com/v1/voice.
Base address: https://api.dialerseat.com/v1/voice. Authenticate with your DialerSeat secret key as a Bearer token, the same key as the rest of the DialerSeat API. Requests and answers are JSON; errors carry a code, a plain message and the field at fault. Test keys work today. Live keys answer 403 live_not_open until live service is open on your project, and the endpoints that need the live carrier (porting, emergency addresses, conferences and recordings) answer 501 not_in_sandbox. The whole API is described in OpenAPI 3.1 at https://api.dialerseat.com/v1/voice/openapi.json.
Numbers
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.DELETE /v1/voice/number_reservations/{id}: Let held numbers go before the 30 minutes are up.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.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.GET /v1/voice/phone_numbers/{id}: One number and everything set on it.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.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.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.
Porting
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.GET /v1/voice/porting_orders: Every porting order and where it stands: draft, submitted, exception, confirmed, completed or canceled.GET /v1/voice/porting_orders/{id}: One port, its numbers, its activation date and any exception the losing carrier raised.PATCH /v1/voice/porting_orders/{id}: Correct the account details after an exception, or change the requested date.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.POST /v1/voice/porting_orders/{id}/documents: Upload the latest bill and letter of authorization a port needs.
Emergency
POST /v1/voice/emergency_addresses: A validated street address for 911. Every number that takes inbound calls needs one before emergency calling works.GET /v1/voice/emergency_addresses: Your addresses and which numbers use each.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.
SIP trunking
POST /v1/voice/sip_connections: A trunk for your PBX, softswitch or dialer. Authenticate by username and password, by your IP addresses, or by your hostnames (FQDN). Choose codecs, encryption, the outbound profile and how inbound calls reach you.GET /v1/voice/sip_connections: Your trunks with their type, outbound profile, numbers and registration state.GET /v1/voice/sip_connections/{id}: One trunk and every setting on it.PATCH /v1/voice/sip_connections/{id}: Change its authentication, allowed IPs, hostnames, codecs, inbound routing or outbound profile.DELETE /v1/voice/sip_connections/{id}: Remove a trunk. Numbers on it must move first.GET /v1/voice/sip_connections/{id}/registration_status: Whether a credential trunk is registered right now, from which address, and when it last registered.GET /v1/voice/sip_connections/{id}/active_calls: The calls up on one connection now, against its channel limit.
Outbound profiles
POST /v1/voice/outbound_voice_profiles: Rules for outbound calls on the connections that use it: allowed destinations, a channel limit, a daily spend limit, a maximum rate per minute, caller ID rules and recording.GET /v1/voice/outbound_voice_profiles: Your profiles and the connections on each.PATCH /v1/voice/outbound_voice_profiles/{id}: Change limits or destinations. Takes effect on the next call.DELETE /v1/voice/outbound_voice_profiles/{id}: Remove a profile no connection uses.
Credentials
POST /v1/voice/telephony_credentials: A per-user SIP login on a connection, for a browser or mobile app to place and take calls: one for each of your agents.GET /v1/voice/telephony_credentials: Every credential, its connection, and when it was last used.POST /v1/voice/telephony_credentials/{id}/token: A short-lived token the browser phone signs in with, so no SIP password ever reaches a page.DELETE /v1/voice/telephony_credentials/{id}: Sign that user out everywhere and remove the login.
Applications
POST /v1/voice/applications: Where a number's calls go: a Voice API application that sends every event to your webhook, or a DSML application that fetches call instructions from your URL (or a hosted DSML document).GET /v1/voice/applications: Your applications, their type and their numbers.PATCH /v1/voice/applications/{id}: Change the webhook or DSML URL, a failover URL, the outbound profile or the events sent.DELETE /v1/voice/applications/{id}: Remove an application no number points at.
Calls
POST /v1/voice/calls: Dial a US number or a SIP address from a number you own. Optional: answering-machine detection, link_to and bridge_on_answer to connect it to another call the moment it is answered, a ring timeout, a hard time limit, recording from answer, audio on answer, custom SIP headers and your own client_state.GET /v1/voice/calls/{id}: Whether a call is alive, how long it has run, and its current state.POST /v1/voice/calls/{id}/actions/answer: Pick up an inbound call that is ringing your application.POST /v1/voice/calls/{id}/actions/reject: Turn an inbound call away with busy or rejected, before answering.POST /v1/voice/calls/{id}/actions/hangup: End the call.call.hangupfollows with the cause.POST /v1/voice/calls/{id}/actions/bridge: Connect this call to another live call so the two parties hear each other.POST /v1/voice/calls/{id}/actions/transfer: Send the call to a new number or SIP address and drop out of it.POST /v1/voice/calls/{id}/actions/speak: Read text to the call in a chosen voice.POST /v1/voice/calls/{id}/actions/playback_start: Play an MP3 or WAV from a URL, once or on a loop.POST /v1/voice/calls/{id}/actions/playback_stop: Stop what is playing.POST /v1/voice/calls/{id}/actions/gather_using_speak: Read a prompt and collect keypad digits, with a timeout and a terminating key.POST /v1/voice/calls/{id}/actions/gather_using_audio: Play a recording and collect keypad digits.POST /v1/voice/calls/{id}/actions/gather_stop: End a gather early.POST /v1/voice/calls/{id}/actions/send_dtmf: Press keys on the far end, for an IVR or an extension.POST /v1/voice/calls/{id}/actions/record_start: Record the call, one channel or two, to MP3 or WAV.POST /v1/voice/calls/{id}/actions/record_stop: Stop and save.call.recording.savedfollows with the file.POST /v1/voice/calls/{id}/actions/record_pause: Pause, for example while a card number is read.POST /v1/voice/calls/{id}/actions/record_resume: Carry on recording into the same file.POST /v1/voice/calls/{id}/actions/streaming_start: Send the call's audio, live, to your WebSocket: for transcription or an AI agent.POST /v1/voice/calls/{id}/actions/streaming_stop: Stop the stream.POST /v1/voice/calls/{id}/actions/client_state_update: Replace the state DialerSeat echoes back on every event for this call.POST /v1/voice/calls/{id}/actions/refer: Ask a SIP endpoint to take the call elsewhere.
Conferences
POST /v1/voice/conferences: A room that starts with one call in it. Choose the beep, hold music and when the room ends.GET /v1/voice/conferences: Rooms that are running or recently ended.GET /v1/voice/conferences/{id}/participants: Who is in a room, muted or on hold.POST /v1/voice/conferences/{id}/actions/join: Add a live call to the conference, muted or on hold if you like.POST /v1/voice/conferences/{id}/actions/leave: Take a call out; it stays up for your next command.POST /v1/voice/conferences/{id}/actions/mute: Mute everyone, or the calls you list.POST /v1/voice/conferences/{id}/actions/unmute: Unmute everyone, or the calls you list.POST /v1/voice/conferences/{id}/actions/hold: Put participants on hold with music.POST /v1/voice/conferences/{id}/actions/unhold: Bring participants back.POST /v1/voice/conferences/{id}/actions/speak: Read text to everyone in the room.POST /v1/voice/conferences/{id}/actions/play: Play audio to everyone in the room.POST /v1/voice/conferences/{id}/actions/record_start: Record the conference as one file.POST /v1/voice/conferences/{id}/actions/record_stop: Stop and save.
Recordings
GET /v1/voice/recordings: Recordings by call, conference, number or date, with length, channels and a download link.GET /v1/voice/recordings/{id}: One recording and a fresh download link.DELETE /v1/voice/recordings/{id}: Delete the audio for good.
DSML
POST /v1/voice/dsml/calls: Dial out and run a DSML document when it is answered: the quickest way to build an outbound flow without a webhook server.POST /v1/voice/dsml_bins: Store a DSML document at a DialerSeat address, for flows that never change.GET /v1/voice/dsml_bins: Your hosted DSML documents and the applications using each.POST /v1/voice/dsml/validate: Parse a document and get back every verb as DialerSeat reads it, or the line and reason it is wrong.
Billing
GET /v1/voice/balance: Prepaid balance, credit, what is pending on live calls, and what is available to spend.GET /v1/voice/ledger: Every top-up, call charge, number charge and refund, newest first, each with the balance after it.POST /v1/voice/balance/top_ups: Top up from the card on file.PATCH /v1/voice/balance/auto_recharge: Top up by a set amount whenever the balance falls under a threshold, so calls never stop for money.GET /v1/voice/rates: The US rate card: per-minute outbound and inbound, toll-free, numbers, answering-machine detection and recording.
Usage
GET /v1/voice/cdrs: Every finished call: from, to, direction, connection, start, answer and end times, billed seconds, rate, cost, hangup cause and answering-machine result.GET /v1/voice/usage: Minutes, calls and cost by day, connection, number or tag.GET /v1/voice/exports/cdrs: Call detail records for a date range as a CSV file.
Webhooks
GET /v1/voice/public_key: The Ed25519 public key every DialerSeat Voice webhook is signed with.GET /v1/voice/call_events: Every event sent for a call and what your server answered: for debugging a flow.
Related:DialerSeat Voice: numbers, SIP and a voice API, Voice: numbers, porting and 911, Voice: SIP trunking and Voice: the Voice API.