List charges | Talkif Docs

{
  "charges": [
    {
      "chargeType": "call_usage",
      "chargeTypeDisplay": "Call Usage",
      "createdAt": "2026-01-15T10:30:00Z",
      "description": "Call to Jane Smith via +15551234567 (Sales Flow)",
      "icon": "phone",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "refundedMicrocents": 0,
      "status": "completed",
      "statusDisplay": "Completed",
      "subtotalMicrocents": 50000,
      "taxMicrocents": 0,
      "totalMicrocents": 50000,
      "totalUsd": 0.05,
      "contactName": "Jane Smith",
      "failureCode": "string",
      "failureReason": "string",
      "flowName": "Sales Flow",
      "phoneNumber": "+15551234567",
      "referenceId": "550e8400-e29b-41d4-a716-446655440000",
      "referenceType": "call"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 142
  }
}

Paginated, filterable charge history for an account. Returns charges with entity context (phone number, flow name, contact name) from the first associated cost line item.

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Query parameters

limitlongOptional

Page size (max 100)

offsetlongOptionalDefaults to 0

Page offset

charge_typeenumOptional

Filter by charge type

statusenumOptional

Filter by status

start_datestringOptional

Filter from date (inclusive)

end_datestringOptional

Filter to date (inclusive)

Response

Paginated charge history

chargeslist of objects

Items on this page

metaobject

Pagination metadata

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error