> ## Documentation Index
> Fetch the complete documentation index at: https://docs.danubeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Wallet Transactions

> List your wallet transactions, newest first, with pagination and an optional type filter

## Overview

Returns the credit wallet's transaction history: deposits, tool execution charges, refunds, payouts and adjustments. Results are ordered newest first and paginated with `limit` and `offset`. This is the same wallet that [Get Wallet Balance](/api-reference/endpoint/get_wallet_balance) reports on, and amounts are in cents.

**Auth:** Requires authentication (JWT or API key).

## Query Parameters

<ParamField query="limit" type="integer" default="50">
  Maximum number of transactions to return. Values above 100 are capped to 100.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of transactions to skip
</ParamField>

<ParamField query="type" type="string">
  Return only one transaction type: `deposit`, `tool_execution`, `refund`, `payout` or `adjustment`. Any other value returns a 400.
</ParamField>

## Response

<ResponseField name="transactions" type="array">
  The page of transactions, newest first.

  <Expandable title="Transaction">
    <ResponseField name="id" type="string">Transaction id</ResponseField>
    <ResponseField name="user_id" type="string">Owner of the wallet</ResponseField>
    <ResponseField name="type" type="string">`deposit`, `tool_execution`, `refund`, `payout` or `adjustment`</ResponseField>
    <ResponseField name="amount_cents" type="integer">Signed amount in cents: positive for deposits, negative for usage</ResponseField>
    <ResponseField name="balance_after_cents" type="integer">Wallet balance in cents after this transaction</ResponseField>
    <ResponseField name="reference_id" type="string | null">Id of the related record, if any</ResponseField>
    <ResponseField name="reference_type" type="string | null">Kind of record `reference_id` points at, such as `stripe_payment`, `tool_execution` or `refund`</ResponseField>
    <ResponseField name="metadata" type="object">Extra details recorded with the transaction</ResponseField>
    <ResponseField name="created_at" type="string | null">When the transaction was recorded (ISO 8601)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="integer">Number of matching transactions across all pages</ResponseField>
<ResponseField name="limit" type="integer">The limit applied to this page, after the cap</ResponseField>
<ResponseField name="offset" type="integer">The offset applied to this page</ResponseField>

## Example

The Python SDK returns the `transactions` list and takes `limit` and `offset`; it does not expose the `type` filter.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.danubeai.com/v1/wallet/transactions?limit=20" \
    -H "danube-api-key: YOUR_API_KEY"
  ```

  ```python Python SDK theme={null}
  from danube import DanubeClient

  with DanubeClient(api_key="YOUR_API_KEY") as client:
      for tx in client.wallet.get_transactions(limit=20):
          print(f"{tx.created_at} {tx.type} {tx.amount_cents / 100:+.2f}")
  ```

  ```typescript TypeScript SDK theme={null}
  import { DanubeClient } from 'danube';

  const client = new DanubeClient({ apiKey: 'YOUR_API_KEY' });
  const transactions = await client.wallet.getTransactions({ limit: 20 });
  for (const tx of transactions) {
    console.log(`${tx.createdAt} ${tx.type} ${(tx.amountCents / 100).toFixed(2)}`);
  }
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "transactions": [
      {
        "id": "7c2d9e4f-1a3b-4c5d-8e6f-0a1b2c3d4e5f",
        "user_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
        "type": "tool_execution",
        "amount_cents": -5,
        "balance_after_cents": 1495,
        "reference_id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
        "reference_type": "tool_execution",
        "metadata": {},
        "created_at": "2026-09-11T14:30:00+00:00"
      },
      {
        "id": "3a4b5c6d-7e8f-4a9b-8c0d-1e2f3a4b5c6d",
        "user_id": "2f1c6c2e-4b7a-4f0e-9a44-0d2c1c1b9c10",
        "type": "deposit",
        "amount_cents": 1500,
        "balance_after_cents": 1500,
        "reference_id": "pi_3Q…",
        "reference_type": "stripe_payment",
        "metadata": {},
        "created_at": "2026-09-10T09:00:00+00:00"
      }
    ],
    "total": 2,
    "limit": 20,
    "offset": 0
  }
  ```
</ResponseExample>