History

List every credit transaction on your account: purchases, consumption deductions, bonuses, and adjustments via GET /v1/credits/history with pagination.

The credit transaction history endpoint (GET /v1/credits/history) returns a chronological ledger of every credit transaction on your Talonic account, most recent first. Transactions include purchases (positive amounts), consumption deductions (negative amounts), bonuses, and manual adjustments. Use it to audit spending and reconcile usage against your balance.

Call this endpoint to build a transaction ledger view or to reconcile credit changes over a billing period. The response uses page-based pagination — pass page and limit query parameters to navigate through large transaction histories. The default page size is 20 with a maximum of 100.

Each transaction includes an amount (negative for deductions, positive for purchases), a type field (consumption, purchase, bonus, or adjustment), and an operation_type that identifies the pipeline operation responsible. The total field in the response gives the full count for pagination math.

Use this alongside the Balance endpoint to understand how your balance arrived at its current value. For aggregate cost analysis by operation type and model, the Usage Summary endpoint provides a more efficient grouped view without per-transaction detail.

Response

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "amount": -70,
      "type": "consumption",
      "description": "Extraction: doc_3j7x9p2q",
      "operation_type": "extraction",
      "created_at": "2026-06-14T10:32:00.000Z"
    }
  ],
  "total": 482,
  "page": 1,
  "limit": 20
}

Errors