> ## Documentation Index > Fetch the complete documentation index at: https://developer.wallbit.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Transactions > Returns the transaction history for the authenticated user using an API Key. Supports pagination and multiple filters to easily search for specific transactions. ## OpenAPI ````yaml GET /api/public/v1/transactions openapi: 3.0.3 info: title: Wallbit Public API description: >- Wallbit Public API allows developers to integrate Wallbit functionality into their applications. Access account balances, view transaction history, and execute trades programmatically using API Keys. version: 1.0.0 contact: name: Wallbit API Support email: dev@wallbit.io servers: - url: https://api.wallbit.io description: Production server - url: http://localhost description: Local development server security: - apiKey: [] tags: - name: Balance description: Endpoints to retrieve account balances - name: Transactions description: Endpoints to retrieve transaction history - name: Trades description: Endpoints to execute trading operations - name: Fees description: >- Endpoints to retrieve fee configuration for the authenticated user (e.g. stock trading fees by subscription tier) - name: Account Details description: Endpoints to obtain bank account details - name: Wallets description: Endpoints to obtain wallet addresses - name: Rates description: Endpoints to retrieve fiat exchange rates from Wallbit - name: Assets description: Endpoints to query information about assets (stocks) and categories - name: Operations description: Endpoints for deposit and withdrawal investment operations - name: Cards description: Endpoints to block and unblock cards - name: API Key description: Endpoints to revoke the API key used for authentication paths: /api/public/v1/transactions: get: tags: - Transactions summary: List user transactions description: >- Returns the transaction history for the authenticated user using an API Key. Supports pagination and multiple filters to easily search for specific transactions. operationId: listTransactions parameters: - name: page in: query description: 'Page number (default: 1)' schema: type: integer minimum: 1 default: 1 - name: limit in: query description: Number of results per page schema: type: integer enum: - 10 - 20 - 50 default: 10 - name: status in: query description: Filter by transaction status schema: type: string example: COMPLETED - name: type in: query description: Filter by transaction type schema: type: string example: TRADE - name: currency in: query description: Filter by currency schema: type: string enum: - USD - EUR - ARS - MXN - USDC - USDT - BOB - COP - PEN - DOP - BRL - PHP - CLP - GTQ - PAB - CRC example: USD - name: from_date in: query description: 'Start date of range (format: Y-m-d)' schema: type: string format: date example: '2024-01-01' - name: to_date in: query description: 'End date of range (format: Y-m-d)' schema: type: string format: date example: '2024-12-31' - name: from_amount in: query description: Minimum amount filter schema: type: number minimum: 0 example: 100 - name: to_amount in: query description: Maximum amount filter schema: type: number minimum: 0 example: 1000 responses: '200': description: List of transactions content: application/json: schema: type: object properties: data: type: object properties: data: type: array items: $ref: '#/components/schemas/Transaction' pages: type: integer description: Total number of pages current_page: type: integer description: Current page number count: type: integer description: Total number of transactions example: data: data: - uuid: 550e8400-e29b-41d4-a716-446655440000 type: WITHDRAWAL_LOCAL external_address: Juan Perez source_currency: code: USD alias: USD dest_currency: code: USD alias: USD source_amount: 100 dest_amount: 100 status: COMPLETED created_at: '2024-01-15T10:30:00.000000Z' comment: null pages: 5 current_page: 1 count: 50 '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '422': $ref: '#/components/responses/ValidationError' '429': $ref: '#/components/responses/TooManyRequests' security: - apiKey: [] components: schemas: Transaction: type: object properties: uuid: type: string format: uuid description: Transaction unique identifier type: type: string description: Transaction type example: WITHDRAWAL_LOCAL external_address: type: string nullable: true description: >- External address used for the transaction (for example, a name in WITHDRAWAL_LOCAL operations) example: Juan Perez source_currency: type: object properties: code: type: string alias: type: string dest_currency: type: object properties: code: type: string alias: type: string source_amount: type: number format: float description: Source amount dest_amount: type: number format: float description: Destination amount status: type: string description: Transaction status created_at: type: string format: date-time description: Creation timestamp comment: type: string nullable: true description: Optional comment Error: type: object properties: message: type: string description: Error message error: type: string description: Error description ValidationError: type: object properties: message: type: string description: Error message errors: type: object description: Field-specific validation errors additionalProperties: type: array items: type: string responses: Unauthorized: description: Missing or invalid API Key content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing: summary: Missing API Key value: message: API Key required. Please provide X-API-Key header. invalid: summary: Invalid API Key value: message: Invalid or expired API Key. Forbidden: description: Insufficient permissions content: application/json: schema: type: object properties: message: type: string your_permissions: type: array items: type: string example: message: 'Insufficient permissions. Required permission: read' your_permissions: - trade ValidationError: description: Validation failed content: application/json: schema: $ref: '#/components/schemas/ValidationError' example: message: The given data was invalid. errors: symbol: - The symbol field is required. TooManyRequests: description: Rate limit exceeded content: application/json: schema: type: object properties: message: type: string retry_after: type: integer description: Seconds until rate limit resets example: message: Too many requests. Please try again later. retry_after: 42 headers: X-RateLimit-Limit: description: Total requests allowed per minute schema: type: integer X-RateLimit-Remaining: description: Requests remaining in current window schema: type: integer X-RateLimit-Reset: description: Unix timestamp when rate limit resets schema: type: integer Retry-After: description: Seconds to wait before retry schema: type: integer securitySchemes: apiKey: type: apiKey name: X-API-Key in: header description: >- API Key authentication. Obtain your API key from the Wallbit dashboard under Settings → API Keys. ````