> ## Documentation Index > Fetch the complete documentation index at: https://docs.rolla.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Get Wallet Transactions > Retrieves a paginated list of wallet transactions with optional filtering. Retrieve a paginated list of wallet transactions with optional filtering by currency, type, status, date range, and search term. ## Example Request ```bash theme={null} curl -X GET "https://api.rolla.xyz/api/v1/external/wallet/transactions?currency=NGN&status=completed&page=1&pageSize=20" \ -H "X-API-Key: your_api_key_here" ``` ## Query Parameters | Parameter | Type | Description | | ----------------- | ------- | ---------------------------------------------------------------------- | | `currency` | string | Filter by 3-letter currency code (e.g. `NGN`, `USD`) | | `transactionType` | string | Filter by type: `deposit`, `withdrawal`, `swap` | | `status` | string | Filter by status: `pending`, `completed`, `failed`, `rejected`, `sent` | | `page` | integer | Page number (default: 1) | | `pageSize` | integer | Results per page (default: 20, max: 100) | | `startDate` | string | Start date filter (YYYY-MM-DD) | | `endDate` | string | End date filter (YYYY-MM-DD) | | `search` | string | Search term to filter transactions | ## Example Response ```json theme={null} { "status": 200, "success": true, "message": "Transaction history retrieved successfully", "data": { "transactions": [ { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "transaction_type": "withdrawal", "status": "completed", "description": "Vendor payment", "external_reference": "ref-abc123", "fee_amount": 53, "source_amount": 500000, "destination_amount": 499947, "source_currency": "NGN", "destination_currency": "NGN", "exchange_rate": null, "created_at": "2024-01-15T10:30:00.000Z", "updated_at": "2024-01-15T10:30:45.000Z" }, { "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "transaction_type": "deposit", "status": "completed", "description": "Inbound transfer", "external_reference": null, "fee_amount": 0, "source_amount": 1000000, "destination_amount": 1000000, "source_currency": "NGN", "destination_currency": "NGN", "exchange_rate": null, "created_at": "2024-01-14T09:00:00.000Z", "updated_at": "2024-01-14T09:01:00.000Z" } ], "totalCount": 150, "page": 1, "pageSize": 20, "totalPages": 8 } } ``` Use date range filters to export transaction data for specific periods. Combine with the `status` filter to find failed transactions that may need to be retried. ## OpenAPI ````yaml GET /wallet/transactions openapi: 3.1.0 info: title: Rolla Developer API description: >- API for programmatic transaction management on the Rolla platform. Monetary `amount` fields use the smallest unit of the referenced currency unless an endpoint says otherwise (e.g. NGN = kobo, USD = cents, where **100 cents = USD 1.00**). version: 1.0.0 servers: - url: https://api.rolla.xyz/api/v1/external description: Production server security: - apiKeyAuth: [] paths: /wallet/transactions: get: summary: Get Wallet Transactions description: >- Retrieves a paginated list of wallet transactions with optional filtering. operationId: getWalletTransactions parameters: - name: currency in: query description: Filter by 3-letter currency code schema: type: string minLength: 3 maxLength: 3 - name: transactionType in: query description: Filter by transaction type schema: type: string enum: - deposit - withdrawal - swap - name: status in: query description: Filter by status schema: type: string enum: - pending - completed - failed - rejected - sent - name: page in: query description: 'Page number (default: 1)' schema: type: integer default: 1 minimum: 1 - name: pageSize in: query description: 'Results per page (default: 20, max: 100)' schema: type: integer default: 20 minimum: 1 maximum: 100 - name: startDate in: query description: Start date filter (YYYY-MM-DD) schema: type: string format: date - name: endDate in: query description: End date filter (YYYY-MM-DD) schema: type: string format: date - name: search in: query description: Search term to filter transactions schema: type: string responses: '200': description: Transactions retrieved successfully content: application/json: schema: type: object properties: status: type: integer example: 200 success: type: boolean example: true message: type: string example: Transaction history retrieved successfully transactions: type: array items: $ref: '#/components/schemas/Transaction' totalCount: type: integer description: Total number of transactions example: 150 page: type: integer description: Current page number example: 1 pageSize: type: integer description: Results per page example: 20 totalPages: type: integer description: Total number of pages example: 8 '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: Transaction: type: object properties: id: type: string format: uuid description: Transaction identifier transaction_type: type: string enum: - deposit - withdrawal - swap description: Transaction type status: type: string enum: - pending - completed - failed - rejected - sent - processing description: Transaction status description: type: string description: Transaction description external_reference: type: string nullable: true description: External reference ID fee_amount: type: number description: >- Fee charged for this transaction. On a `fee` transaction this is `0` — the fee value is carried as that row's source_amount/destination_amount, so totalling fee_amount across transactions does not double-count it. fee_transaction_id: type: string format: uuid description: >- Where the fee is charged to a different account rather than deducted from this transaction, the id of the separate transaction it was booked as. Omitted when no such transaction exists. fee_reference: type: string description: >- Reference of that fee transaction, in the form `FEE-XXXXXXXX`. Omitted when no separate fee transaction exists. example: FEE-9J76UADV related_transaction_id: type: string format: uuid description: >- On a `fee` transaction, the id of the transaction the fee was charged for — the reverse of fee_transaction_id. Omitted on transactions that are not fees. related_reference: type: string description: >- Reference of that originating transaction. Omitted on transactions that are not fees. source_amount: type: number description: >- Amount debited from the source wallet. Normally amount + fee for a payout, but equal to the amount when the fee is charged to a separate account. Never derive the fee from this — read fee_amount. destination_amount: type: number description: Amount credited to the destination wallet source_currency: type: string description: Currency of the source wallet destination_currency: type: string description: Currency of the destination wallet created_at: type: string format: date-time description: Transaction creation timestamp updated_at: type: string format: date-time description: Last update timestamp Error: type: object properties: success: type: boolean example: false message: type: string securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-Key description: Your Rolla API key ````