> ## Documentation Index > Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Transactions > List all business wallet transactions with category, status, and fee data. GET /account/transactions. ## Overview Retrieve a paginated list of all transactions on your business account. This includes card issuance, funding, unloading, termination, transfers, collections, payouts, and deposits. ## Filtering | Parameter | Description | | --------- | ---------------------------------------------------------------- | | `type` | Filter by transaction direction: `CREDIT` or `DEBIT` | | `status` | Filter by status: `PENDING`, `COMPLETED`, `FAILED`, `PROCESSING` | ## Pagination | Parameter | Default | Max | | --------- | ------- | --- | | `page` | 1 | - | | `perPage` | 50 | 100 | ## Response Fields | Field | Type | Description | | --------------- | ------ | ----------------------------------------------------------------------------------------------------------------------- | | `transactionId` | string | Unique transaction batch ID | | `reference` | string | Card ID, payment reference, or on-chain hash depending on category | | `type` | string | `CREDIT` or `DEBIT` | | `category` | string | `DEPOSIT`, `WITHDRAW`, `ISSUANCE`, `FUNDING`, `UNLOADING`, `TERMINATION`, `TRANSFER`, `COLLECTION`, `PAYOUT`, `AIRTIME` | | `amount` | number | Transaction amount | | `fee` | number | Fee charged for this transaction | | `currency` | string | `USD` or `USDT` for crypto deposits | | `status` | string | `PENDING`, `COMPLETED`, `FAILED`, or `PROCESSING` | | `description` | string | Cardholder name, counterparty, or asset name | | `createdAt` | string | ISO 8601 timestamp | | `updatedAt` | string | ISO 8601 timestamp of last status change | ## Example Usage ```javascript theme={null} const response = await fetch('https://api.fyatu.com/api/v3/account/transactions?page=1&perPage=50', { headers: { 'Authorization': `Bearer ${accessToken}` } }); const { data } = await response.json(); console.log(`Total transactions: ${data.pagination.totalItems}`); data.transactions.forEach(tx => { console.log(`${tx.type} (${tx.category}): $${tx.amount} — ${tx.description}`); console.log(` Status: ${tx.status}, Fee: $${tx.fee}`); }); ``` ## OpenAPI ````yaml v3/openapi.json GET /account/transactions openapi: 3.1.0 info: title: FYATU API v3 description: >- FYATU API v3 with JWT authentication for Collections, Payouts, and Card Issuing. version: 3.0.0 contact: name: FYATU Support url: https://fyatu.com email: support@fyatu.com servers: - url: https://api.fyatu.com/api/v3 description: Production security: [] tags: - name: Authentication description: JWT token management endpoints - name: Account description: Business account, wallet, and address management - name: Collections description: Accept payments from customers via checkout sessions - name: Refunds description: Issue refunds for completed collections - name: Payouts description: Send money to Fyatu account holders - name: Cardholders description: Cardholder management for card issuing programs - name: Cards description: Issue, fund, freeze, and manage virtual cards - name: Webhooks description: Webhook configuration and management paths: /account/transactions: get: tags: - Account summary: Get Transactions description: >- Retrieve paginated list of all business account transactions. Supports filtering by type (CREDIT/DEBIT) and status. operationId: getTransactions parameters: - name: page in: query description: Page number schema: type: integer default: 1 minimum: 1 - name: perPage in: query description: Items per page (max 100) schema: type: integer default: 50 minimum: 1 maximum: 100 - name: type in: query description: Filter by transaction type schema: type: string enum: - CREDIT - DEBIT - name: status in: query description: Filter by status schema: type: string enum: - PENDING - COMPLETED - FAILED responses: '200': description: Transactions retrieved successfully content: application/json: schema: $ref: '#/components/schemas/TransactionsResponse' example: success: true status: 200 message: Transactions retrieved successfully data: pagination: page: 1 perPage: 50 totalItems: 7 totalPages: 1 transactions: - transactionId: DEP69FE561280613 reference: CQDX4LIBSORF type: CREDIT category: DEPOSIT amount: 100 fee: 0 currency: USD status: COMPLETED description: Deposit of 100 USD createdAt: '2026-05-08T21:30:58Z' updatedAt: '2026-05-08T21:30:58Z' - transactionId: FYB69F984AA38EFB reference: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1 type: DEBIT category: ISSUANCE amount: 30 fee: 5 currency: USD status: COMPLETED description: Card Issuance - 515253******1234 (Alice Example) createdAt: '2026-05-05T08:00:00Z' updatedAt: '2026-05-05T08:00:15Z' - transactionId: FYB69E12BC34DE56 reference: a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1 type: DEBIT category: FUNDING amount: 50 fee: 0.5 currency: USD status: COMPLETED description: Card Funding - 515253******1234 (Alice Example) createdAt: '2026-05-05T09:00:00Z' updatedAt: '2026-05-05T09:00:00Z' - transactionId: FYB69A78CD90EF12 reference: b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2 type: CREDIT category: UNLOADING amount: 20 fee: 0 currency: USD status: COMPLETED description: Card Unload - 515253******5678 (Bob Example) createdAt: '2026-05-06T10:00:00Z' updatedAt: '2026-05-06T10:00:00Z' - transactionId: FYB69B11CC22DD33 reference: b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2 type: CREDIT category: TERMINATION amount: 15 fee: 0 currency: USD status: COMPLETED description: Card Termination - 515253******5678 (Bob Example) createdAt: '2026-05-07T11:00:00Z' updatedAt: '2026-05-07T11:00:00Z' - transactionId: FYB69EE099B77FBB reference: P2P69EE099B741DB type: CREDIT category: TRANSFER amount: 25 fee: 0 currency: USD status: COMPLETED description: Bob Example createdAt: '2026-05-07T14:00:00Z' updatedAt: '2026-05-07T14:00:00Z' - transactionId: DEP67EA9E8789B79 reference: >- c802f8a9db4c15878ea43bdff610261ff1df7726dccfc4b6365e4e44d62dac88 type: CREDIT category: DEPOSIT amount: 43.65 fee: 1.35 currency: USDT status: COMPLETED description: USDT createdAt: '2026-05-08T09:00:00Z' updatedAt: '2026-05-08T09:00:00Z' meta: requestId: req_7af4d2b8e91c35fa4b21890e timestamp: '2026-05-08T21:42:53Z' '401': $ref: '#/components/responses/Unauthorized' security: - BearerAuth: [] components: schemas: TransactionsResponse: type: object properties: success: type: boolean example: true status: type: integer example: 200 message: type: string data: $ref: '#/components/schemas/TransactionsData' meta: $ref: '#/components/schemas/Meta' TransactionsData: type: object properties: transactions: type: array items: $ref: '#/components/schemas/Transaction' pagination: $ref: '#/components/schemas/Pagination' Meta: type: object properties: requestId: type: string description: Unique request ID for tracking example: req_abc123def456 timestamp: type: string format: date-time description: ISO 8601 timestamp of the response ErrorResponse: type: object properties: success: type: boolean example: false status: type: integer example: 401 message: type: string example: Invalid credentials error: $ref: '#/components/schemas/Error' meta: $ref: '#/components/schemas/Meta' Transaction: type: object properties: transactionId: type: string description: Unique transaction batch ID reference: type: string description: Card ID, payment reference, or on-chain hash type: type: string enum: - CREDIT - DEBIT category: type: string enum: - DEPOSIT - WITHDRAW - ISSUANCE - FUNDING - UNLOADING - TERMINATION - TRANSFER - COLLECTION - PAYOUT - AIRTIME amount: type: number description: Transaction amount fee: type: number description: Fee charged currency: type: string description: USD or USDT for crypto deposits status: type: string enum: - PENDING - COMPLETED - FAILED - PROCESSING description: type: string description: Cardholder name, counterparty, or asset name createdAt: type: string format: date-time updatedAt: type: string format: date-time Pagination: type: object properties: page: type: integer perPage: type: integer totalItems: type: integer totalPages: type: integer Error: type: object properties: code: type: string description: Error code for programmatic handling example: AUTH_INVALID_CREDENTIALS details: type: array items: $ref: '#/components/schemas/ValidationError' description: Validation error details (for VALIDATION_ERROR) ValidationError: type: object properties: field: type: string description: Field that failed validation example: appId message: type: string description: Validation error message example: AppId is required responses: Unauthorized: description: Authentication required or token invalid content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false status: 401 message: Unable to identify business error: code: AUTH_TOKEN_INVALID meta: requestId: req_abc123 timestamp: '2026-01-05T10:30:00+00:00' securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: JWT access token obtained from /auth/token ````