Skip to main content
GET
/
charges_breakdown
JavaScript
import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: 'My API Key',
});

const chargesBreakdown = await client.chargesBreakdown.retrieve({ start_date: '2025-05-01' });

console.log(chargesBreakdown.data);
{
  "data": {
    "user_id": "0db0b4aa-a83d-4d4f-ad9b-3ba7c1ac2ce8",
    "start_date": "2025-05-01",
    "end_date": "2025-06-01",
    "user_email": "user@example.com",
    "currency": "USD",
    "results": [
      {
        "tn": "+15551234567",
        "charge_type": "local",
        "service_owner_user_id": "0db0b4aa-a83d-4d4f-ad9b-3ba7c1ac2ce8",
        "service_owner_email": "user@example.com",
        "services": [
          {
            "cost_type": "MRC",
            "name": "Local DIDs",
            "cost": "1.50"
          }
        ]
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

start_date
string<date>
required

Start date for the charges breakdown in ISO date format (YYYY-MM-DD)

Example:

"2025-05-01"

end_date
string<date>

End date for the charges breakdown in ISO date format (YYYY-MM-DD). If not provided, defaults to start_date + 1 month. The date is exclusive, data for the end_date itself is not included in the report. The interval between start_date and end_date cannot exceed 31 days.

Example:

"2025-06-01"

format
enum<string>
default:json

Response format

Available options:
json,
csv
Example:

"json"

Response

Monthly charges breakdown

data
object
required