API documentation

GET /charge_rollups

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/charge_rollups

List billing records.

Returns aggregated billing records rolled up into hourly buckets per company, charge type, offer, and schedule, for reporting on charges such as calls, SMS, transcriptions, and number fees without querying individual charges. Filter by charge_type, offer_id, schedule_id, or ids, plus the standard date-range filters; the response includes summary totals. Requires the Billing permission.

Params

Param name	Description
charge_type Optional	Different types of charges including calls, SMS, transcriptions, reporting, and number-related fees. Must be a String
offer_id Optional	Refer to the offer api for details Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers
schedule_id Optional	Schedule internal id. Must be a valid foreign key reference to an Schedule. Refer to: /api/docs/1.0/schedules
ids Optional	Return records matching these ids. Must be an array of decimal values. EG: `[0, 1, 2, 3]`
page Optional	Return the next page of results. Must be a number.
per_page Optional	How many results to return per page. The default is 25. Must be a number.
created_at_to Optional	Date formatted like 2016-01-01 12:25:15 -0500 Must be a String
created_at_from Optional	Date formatted like 2016-01-01 12:25:15 -0500 Must be a String
fulltext Optional	Search for any record that matches this text Must be a String
time_zone Optional	Date ranges will be parsed using this time zone. Must be a valid time zone. See the list of valid time zones.
columns Optional	Specify the columns you would like returned by the API for a given resource. Limiting the columns can significantly increase API response time since only the requested data will be processed. columns=uuid,number,created_at Must be any combination of: id legacy_id type uuid created_at updated_at deleted_at user_updated_at routes_show_path routes_edit_path external_record_id name company_id charge_type offer_id schedule_id amount sms_blast_messages_count third_party_cost sms_ai_charges_count charges_count lead_action_logs_count transcriptions_count dnc_check_logs_count Must be a String
root Optional	Pass `root=false` to return results without a root node and metadata. For example: `GET /api/v1/calls?root=false` will return `[call1, call2, call3]` While: `GET /api/v1/calls` will return `{calls: [call1, call2, call3], metadata: {}}` Must be a boolean value: 1, true, yes, on, 0, false, no, off

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/charge_rollups/?per_page=2' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "charge_rollups": [
    {
      "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "type": "ChargeRollup",
      "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "created_at": "2026-01-15T14:30:00.000Z",
      "updated_at": "2026-01-15T15:30:00.000Z",
      "deleted_at": null,
      "user_updated_at": null,
      "routes_show_path": "/billing/usage/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "routes_edit_path": "/billing/usage/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
      "external_record_id": null,
      "name": "a0d49c48 Inbound Call 1.98",
      "company_id": 10001,
      "charge_type": "Inbound Call",
      "offer_id": null,
      "schedule_id": null,
      "amount": "1.98",
      "sms_blast_messages_count": null,
      "sms_ai_charges_count": null,
      "charges_count": 44,
      "lead_action_logs_count": null,
      "transcriptions_count": null,
      "dnc_check_logs_count": null
    },
    {
      "id": "a09e6bca-255b-4217-af73-cb9601c80217",
      "type": "ChargeRollup",
      "uuid": "a09e6bca-255b-4217-af73-cb9601c80217",
      "created_at": "2026-01-15T14:30:00.000Z",
      "updated_at": "2026-01-15T13:30:00.000Z",
      "deleted_at": null,
      "user_updated_at": null,
      "routes_show_path": "/billing/usage/a09e6bca-255b-4217-af73-cb9601c80217",
      "routes_edit_path": "/billing/usage/a09e6bca-255b-4217-af73-cb9601c80217/edit",
      "external_record_id": null,
      "name": "da771aa5 Outbound Call 1.10",
      "company_id": 10001,
      "charge_type": "Outbound Call",
      "offer_id": null,
      "schedule_id": null,
      "amount": "1.105",
      "sms_blast_messages_count": null,
      "sms_ai_charges_count": null,
      "charges_count": 17,
      "lead_action_logs_count": null,
      "transcriptions_count": null,
      "dnc_check_logs_count": null
    }
  ],
  "totals": {
    "id": 10002,
    "amount": 3037.43,
    "charges_count": 11241,
    "sms_ai_charges_count": 0
  },
  "metadata": {
    "root": "charge_rollups",
    "page": 1,
    "total_pages": 516,
    "per_page": 2,
    "total_count": 1032,
    "next_cursor": 10003
  }
}

Params

Must be any combination of: