Usage & Billing

AgentPhone uses pay-as-you-go billing. Every account starts with a $5.00 free credit — no credit card required. You pay only for what you use, and your balance is debited automatically as you make calls, send SMS, and maintain phone numbers.

Pricing

The denoising surcharge applies when an agent’s denoisingMode is set to "noise-and-background-speech-cancellation". The default mode ("noise-cancellation") has no surcharge.

Voice calls are billed per second with a 1¢ minimum. Phone number fees are charged on provisioning and renew every 30 days.

Call recording add-on

Call recording is an optional add-on at $5.00/month (billed from your credit balance). When enabled, all voice calls are automatically recorded and the audio URL is included in call responses via the recordingUrl field.

Enable or disable recording from the Billing page in the dashboard. The fee is charged immediately on activation and renews every 30 days. If you cancel, recording stays active until the end of the current billing period. Existing recordings are preserved even after cancellation.

See Calls > Call recording for response field details.

Balance & auto-recharge

Your project maintains a dollar balance. Usage is debited in real time. When your balance drops below a threshold you set, AgentPhone can automatically charge your card on file to top up.

Configure auto-recharge from the Billing page in the dashboard:

• Threshold — recharge when balance falls below this amount
• Recharge amount — how much to add each time

If auto-recharge is not enabled and your balance runs low, you’ll receive an email notification. Phone numbers with unpaid renewals enter a 30-day grace period before being released.

Get usage

Retrieve current usage statistics for your project.

GET /v1/usage

Example

$
curl -X GET "https://api.agentphone.ai/v1/usage" \
>
  -H "Authorization: Bearer YOUR_API_KEY"

1
{
2
  "plan": {
3
    "name": "starter",
4
    "limits": {
5
      "numbers": 10,
6
      "messagesPerMonth": 5000,
7
      "voiceMinutesPerMonth": 300,
8
      "maxCallDurationMinutes": 30,
9
      "concurrentCalls": 1
10
    }
11
  },
12
  "numbers": {
13
    "used": 3,
14
    "limit": 10,
15
    "remaining": 7
16
  },
17
  "stats": {
18
    "totalMessages": 4500,
19
    "messagesLast24h": 120,
20
    "messagesLast7d": 850,
21
    "messagesLast30d": 3200,
22
    "totalCalls": 200,
23
    "callsLast24h": 8,
24
    "callsLast7d": 45,
25
    "callsLast30d": 160,
26
    "totalWebhookDeliveries": 4700,
27
    "successfulWebhookDeliveries": 4650,
28
    "failedWebhookDeliveries": 50
29
  },
30
  "periodStart": "2025-01-08T12:00:00Z",
31
  "periodEnd": "2025-01-15T12:00:00Z"
32
}

Daily usage

Get a daily breakdown of usage for the last N days. Returns per-day counts of messages, calls, and webhook deliveries.

GET /v1/usage/daily

Query parameters

Example

$
curl -X GET "https://api.agentphone.ai/v1/usage/daily?days=7" \
>
  -H "Authorization: Bearer YOUR_API_KEY"

1
{
2
  "data": [
3
    {
4
      "date": "2025-01-09",
5
      "messages": 12,
6
      "calls": 3,
7
      "webhooks": 15
8
    },
9
    {
10
      "date": "2025-01-10",
11
      "messages": 8,
12
      "calls": 5,
13
      "webhooks": 13
14
    }
15
  ],
16
  "days": 7
17
}

Monthly usage

Get monthly usage aggregation for the last N months. Returns per-month totals of messages, calls, and webhook deliveries.

GET /v1/usage/monthly

Query parameters

Example

$
curl -X GET "https://api.agentphone.ai/v1/usage/monthly?months=3" \
>
  -H "Authorization: Bearer YOUR_API_KEY"

1
{
2
  "data": [
3
    {
4
      "month": "2024-11",
5
      "messages": 342,
6
      "calls": 87,
7
      "webhooks": 429
8
    },
9
    {
10
      "month": "2024-12",
11
      "messages": 510,
12
      "calls": 124,
13
      "webhooks": 634
14
    }
15
  ],
16
  "months": 3
17
}

Provisioning limits

Each account can provision up to 10 phone numbers self-serve. Need more? Contact us and we’ll increase your limit.

To provision a number, your balance must be at least $3.00 (the first month’s fee is charged immediately).

Monitoring usage

Use the daily and monthly endpoints to track trends and manage spend:

$
# Check current usage
$
curl -s "https://api.agentphone.ai/v1/usage" \
>
  -H "Authorization: Bearer YOUR_API_KEY" | jq '.numbers'
$
$
# Check daily trend for the last week
$
curl -s "https://api.agentphone.ai/v1/usage/daily?days=7" \
>
  -H "Authorization: Bearer YOUR_API_KEY" | jq '.data'

Set up auto-recharge to keep your account funded automatically, or monitor your balance and top up manually from the Billing page.

Plan limits

Every account has a plan with usage limits. The GET /v1/usage response includes a plan.limits object with your current caps.

When you hit a limit, the API returns a 429 error. To raise your limits, contact us.