Get a phone number's billable calls by external ID
GET/v1/businesses/external-id/{externalId}/phone-numbers/{phoneNumber}/billable-calls
Returns billable call counts for one phone number of a business,
identified by your own externalId, over the given date range,
bucketed by granularity. A number without billable calls for this
business in the range returns 404, the same as a number that isn't
this business's.
Path Parameters
Your own reference for the business, optionally supplied when it was created. Restricted to letters, digits,
.
_
-
externalId
businessId
externalId
404
Possible values: non-empty and <= 200 characters, Value must match regular expression ^[A-Za-z0-9._-]+$
partner-customer-7421An E.164 phone number, URL-encoded — the leading
+
%2B
%2B12065550123
Possible values: Value must match regular expression ^\+[1-9]\d{1,14}$
+12065550123Query Parameters
Start of the date range (inclusive), as
YYYY-MM-DD
endDate
endDate
startDate
2026-05-01End of the date range (inclusive), as
YYYY-MM-DD
startDate
endDate
startDate
2026-05-31How to bucket the returned series. Defaults to
total
Possible values: [total, day, week, month]
totalResponses
- 200
- 400
- 401
- 404
- 500
The phone number's billable call counts.
Response Body
A query parameter is invalid — the range is reversed or longer than
15 months, or granularity is unknown.
Response Body
The API key is missing or invalid.
Response Body
No business with that external ID exists or it isn't one of yours, or
the phone number had no billable calls for this business in the range
— the cases are indistinguishable by design. A phone number in the
path that isn't valid E.164 also returns 404.
Response Body
Something went wrong on our side.
Response Body