Get billing status | Dial — Communication Stack for AI Agents

{
  "balanceCents": 23500,
  "subscription": {
    "periodStart": "2024-04-01T00:00:00Z",
    "periodEnd": "2024-05-01T00:00:00Z",
    "quantity": 3,
    "interval": "monthly",
    "cancelAtPeriodEnd": false
  },
  "numbers": [
    {
      "id": "num_01F8ZJ2X9Y7K8QW3R4T5V6B7N8",
      "number": "+14155550123",
      "nickname": "Support line",
      "mode": "FIXED"
    },
    {
      "id": "num_02G9YK3Z0A8L9RX4S5U6W7X8Y9",
      "number": "+14155550987",
      "nickname": "Sales",
      "mode": "PAYG"
    }
  ],
  "deposits": [
    {
      "createdAt": "2024-04-10T15:45:00Z",
      "amountCents": 5000,
      "kind": "card",
      "invoiceId": "in_1QabcdEFghij"
    },
    {
      "createdAt": "2024-03-01T12:00:00Z",
      "amountCents": 1000,
      "kind": "welcome",
      "invoiceId": null
    }
  ],
  "pricing": {
    "monthlyCents": 1200,
    "annualCents": 12000
  },
  "paymentMethods": [
    {
      "id": "pm_1F8ZJ2X9Y7K8QW3R",
      "type": "card",
      "brand": "visa",
      "last4": "4242",
      "expMonth": 4,
      "expYear": 2027,
      "email": null,
      "isDefault": true
    },
    {
      "id": "pm_2G9YK3Z0A8L9RX4S",
      "type": "link",
      "brand": "",
      "last4": "",
      "expMonth": 0,
      "expYear": 0,
      "email": "user@example.com",
      "isDefault": false
    }
  ]
}

Returns the account’s credit-wallet balance, the current subscription (if any), each phone number’s billing mode (PAYG or FIXED), and recent usage.

Authentication

AuthorizationBearer

Your Dial API key, sent as Authorization: Bearer sk_live_...

Response

Billing status.

balanceCentsinteger

Credit-wallet balance in USD cents. May be negative.

subscriptionobject or null

The current subscription, or null when the account is pay-as-you-go.

numberslist of objects

depositslist of objects

Recent credits added to the wallet, most recent first.

pricingobject

Per-number subscription unit prices (USD cents), read from Stripe (the source of truth). Stripe is a dependency of this endpoint.

paymentMethodslist of objects

Saved payment methods on the account’s Stripe customer (all reusable types — card, Link, …), used for top-ups and subscription billing. Empty until one is added. Read live from Stripe, with the default first.

Errors

401

Unauthorized Error

$	curl https://getdial.ai/api/v1/billing \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"