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

# getTransactionList

> Fetches a paginated list of transactions with optional filtering.

## Usage

```typescript theme={null}
const result = await sdk.getTransactionList(
  {
    page: 1,
    limit: 10,
    walletAddress: "0x...",
  },
  bearerToken,
);
```

## Parameters

| Parameter        | Type     | Required | Description                                             |
| ---------------- | -------- | -------- | ------------------------------------------------------- |
| `page`           | `number` | No       | Page number (default: `1`)                              |
| `limit`          | `number` | No       | Results per page (default: `10`)                        |
| `walletAddress`  | `string` | No       | Filter by wallet address                                |
| `calledFunction` | `string` | No       | Filter by contract function name                        |
| `day`            | `number` | No       | Filter by day (1–31)                                    |
| `month`          | `number` | No       | Filter by month (1–12)                                  |
| `year`           | `number` | No       | Filter by year                                          |
| `bearerToken`    | `string` | No       | JWT token. Falls back to `apiSecretKey` if not provided |

## Return Value

Returns a `Promise<PaginatedResponse<Transaction>>` with `items`, `total`, `page`, and `limit`.

## Example

```typescript theme={null}
const result = await sdk.getTransactionList(
  {
    page: 1,
    limit: 20,
    walletAddress: "0x04...abc",
    month: 2,
    year: 2026,
  },
  bearerToken,
);

console.log(`Found ${result.total} transactions`);
result.items.forEach((tx) => {
  console.log(tx.transactionHash, tx.status);
});
```