Get charge detail | Talkif Docs

{
  "chargeType": "call_usage",
  "chargeTypeDisplay": "Call Usage",
  "createdAt": "2026-01-15T10:30:00Z",
  "description": "Call to Jane Smith via +15551234567",
  "icon": "phone",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "lineItems": [
    {
      "amountUsd": 0.03,
      "billableId": "660e8400-e29b-41d4-a716-446655440000",
      "billableType": "call",
      "category": "llm_conversation",
      "categoryDisplay": "LLM Conversation",
      "createdAt": "2026-01-15T10:30:00Z",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "usageData": {},
      "rateMicrocents": 15000,
      "rateUnit": "per_1k_tokens",
      "usageQuantity": 1500,
      "usageUnit": "tokens"
    }
  ],
  "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"
}

Detailed charge view with cost line items breakdown.

Authentication

AuthorizationBearer

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

Path parameters

chargeIdstringRequiredformat: "uuid"

Charge ID

Response

Charge detail with line items

chargeTypeenum

Type of charge

chargeTypeDisplaystring

Human-readable charge type label

createdAtdatetime

When the charge was created

descriptionstring

Human-readable charge description

iconstring

Icon hint for rendering this charge type.

idstringformat: "uuid"

Unique charge identifier

lineItemslist of objects

Granular cost breakdown line items

refundedMicrocentslong

Amount refunded in microcents

statusenum

Current charge status

statusDisplaystring

Human-readable status label

subtotalMicrocentslong

Subtotal before tax in microcents

taxMicrocentslong

Tax amount in microcents

totalMicrocentslong

Total charge amount in microcents

totalUsddouble

Total charge amount in USD

contactNamestring or nullOptional

Contact name associated with this charge

failureCodestring or nullOptional

Stripe failure code if charge failed

failureReasonstring or nullOptional

Human-readable failure reason

flowNamestring or nullOptional

Flow name associated with this charge

phoneNumberstring or nullOptional

Phone number associated with this charge

referenceIdstring or nullOptionalformat: "uuid"

ID of the referenced entity

referenceTypestring or nullOptional

Type of referenced entity (call, phone, etc.)

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error