History

Get credit transaction history including purchases, deductions, and adjustments with page-based pagination.

Retrieve a chronological log of every credit transaction on your account. Transactions include purchases (positive amounts), consumption deductions (negative amounts), bonuses, and manual adjustments. Use this to audit spending and reconcile usage.

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": "2024-09-14T10:32:00.000Z"
    }
  ],
  "total": 482,
  "page": 1,
  "limit": 20
}

Errors