Skip to main content

List billable calls

GET 
/v1/businesses/billable-calls

Returns billable call counts for your businesses over the given date range, one entry per business, bucketed by granularity. Sortable by legal name or by billable calls; paged.

Lists businesses that have completed verification, including ones with no billable calls in the range and ones shut down since, for the ranges in which they belonged to you. A business that belonged to you for only part of the range is listed with the calls of those days. Businesses still UNDER_REVIEW are not included; you can query them individually by businessId or externalId.

Query Parameters​

    startDate string<date>required

    Start of the date range (inclusive), as 

    YYYY-MM-DD
    . Must be on or before 
    endDate
    . 
    endDate
    may be at most 
    startDate
    plus 15 months, with the day clamped to the end of the month (2026-01-31 → 2027-04-30).

    Example: 2026-05-01
    endDate string<date>required

    End of the date range (inclusive), as 

    YYYY-MM-DD
    . Must be on or after 
    startDate
    . 
    endDate
    may be at most 
    startDate
    plus 15 months, with the day clamped to the end of the month (2026-01-31 → 2027-04-30).

    Example: 2026-05-31
    granularity billing_Granularity (string)

    How to bucket the returned series. Defaults to 

    total
    (no series, just the total for the range).

    Possible values: [total, day, week, month]

    Default value: total
    sortBy string

    Field to sort the business list by. 

    legalName
    sorts alphabetically, ignoring case; 
    total
    sorts by the billable calls for the range. Ties are broken by 
    businessId
    , ascending regardless of 
    sortDirection
    .

    Possible values: [legalName, total]

    Default value: legalName
    Example: total
    sortDirection string

    Sort direction. 

    asc
    or 
    desc
    (case-insensitive).

    Possible values: Value must match regular expression ^[Aa][Ss][Cc]$|^[Dd][Ee][Ss][Cc]$

    Default value: asc
    page integer

    Page number, starting at 0. A page past the end returns 

    200
    with an empty list and unchanged 
    paging
    totals.

    Possible values: >= 0 and <= 100000

    Default value: 0
    size integer

    Number of items per page.

    Possible values: >= 1 and <= 200

    Default value: 50

Responses​

A page of per-business billable call counts.

Response Body

application/json