Billing and limits

Credits

Each check of one number uses 1 credit. DID monitoring uses the same credits as the rest of the CallerAPI API.

Action	Credits
One check of one number	1
A check with the result `unknown`	1
Submit numbers	0
Read results, the schedule, or the webhook	0
Webhook deliveries and test events	0
Remove a number	0

CallerAPI takes the credit before the check runs. A check that ends as unknown also uses 1 credit.

Credit estimate

The number of checks in a month is the number of numbers multiplied by the checks for each number. The default schedule is one check a day. This gives about 30.4 checks a month for each number.

Numbers	Schedule	Credits in a month (about)
100	Every 24 hours	3,040
100	Every 12 hours	6,080
1,000	Every 24 hours	30,400

GET /api/did-monitoring/v1/schedule and PUT /api/did-monitoring/v1/schedule return estimate. It gives the checks in a month for your numbers and your schedule, and the credits that your plan includes.

If the estimate is more than the credits that your plan includes, CallerAPI saves the schedule as paused. Then estimate.over_plan is true and state is paused. Choose a longer interval, fewer days, or fewer numbers.

When credits run out

CallerAPI pauses the checks for the account.

CallerAPI sends an email to the account email address.

state is paused and next_check_at is null.

When the account has credits again, the checks start again. You do not need to do anything.

New numbers do not get a first check while checks are paused for credits.

Limits

Limit	Value
Monitored numbers	At most the number of credits that your plan includes each month
Numbers in one submit request	100,000
Webhook URLs	1 for each account. Not available on the Free plan.
Write requests (POST, PUT, DELETE)	60 a minute for each account
Page size for `GET /numbers`	Default 50, maximum 100
First pass for new numbers	About 80 numbers a minute
Check schedule	Every 15 minutes to every 24 hours
Set times of day	1 to 24

Monitored numbers

The number of monitored numbers cannot be more than the credits that your plan includes each month. For example, a plan with 5,000 credits each month can monitor at most 5,000 numbers. A submit request that goes over this limit returns 403. It does not add any of the numbers.

To monitor more numbers, change to a larger plan, or remove numbers that you do not need.

Write requests

POST, PUT, and DELETE requests to DID monitoring are limited to 60 a minute for each account. Over this limit, the response is 429. Wait one minute and send the request again. GET requests do not count toward this limit.

Check schedule

New accounts check each number one time a day, every day, in UTC. Scheduled checks are on by default.

You can choose one of these:

`mode`	Fields	Values
`interval`	`interval_minutes`	15, 30, 60, 120, 180, 240, 360, 480, 720, or 1440
`times`	`times`	1 to 24 times of day, like `"09:00"`

You can also set these fields:

Field	Meaning
`enabled`	`false` stops scheduled checks. New numbers still get their first check.
`timezone`	An IANA time zone, like `America/New_York`. The default is `UTC`.
`weekdays`	Days to check. 1 is Monday and 7 is Sunday. The default is all days.
`start`, `end`	The hours to check in, like `"08:00"` and `"18:00"`. The default is all day.

Send only the fields that you want to change. The other fields keep their saved values.

Credits#

Credit estimate#

When credits run out#

Limits#

Monitored numbers#

Write requests#