Go back to dialerseat.comsales@dialerseat.com
Voice

Voice: balance and billing

A prepaid balance with auto-recharge, a ledger of every charge, call detail records and usage reports. Rates are published when live service opens.


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.

DialerSeat Voice is prepaid. Add funds, and every call, number and porting fee is charged against the balance as it happens, so there is never a bill you did not see coming. Rates are published when live service opens; email dev@dialerseat.com to talk about volume.

Balance

  • 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.

While a call is up, a minute of it is held from your available balance, so an account with less than a minute of money cannot start a call; the hold is released when the call is charged. A call that has already happened is always written to the ledger, even if it takes the balance below zero, so no call ever disappears from your records. balance.low arrives when the balance crosses your threshold, and balance.recharged when auto-recharge tops it up.

What is charged

  • Outbound minutes, by destination: the 48 states, Alaska and Hawaii, the territories, toll-free.
  • Inbound minutes, local and toll-free.
  • Numbers: a monthly charge per number, local or toll-free.
  • Answering-machine detection, per answered call where it ran: standard or premium.
  • Recording and conferences, per minute.
  • An unanswered call costs nothing.

Call records and 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.
  • GET /v1/voice/rates: The US rate card: per-minute outbound and inbound, toll-free, numbers, answering-machine detection and recording.

Related:DialerSeat Voice: numbers, SIP and a voice API, Voice: numbers, porting and 911, Voice: SIP trunking and Voice: the Voice API.