> ## 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 Statement

> Get the last 100 ledger entries for your business account with running balance snapshots. GET /account/statement.

## Overview

Retrieve the last 100 ledger entries for your business account. Each entry includes the account balance **before** and **after** the operation, derived from the immutable double-entry ledger.

This endpoint is designed for accounting and reconciliation use cases where you need to verify the exact balance impact of each operation.

<Note>
  For a standard transaction list (category, fee, status, reference), use `GET /account/transactions` instead. The statement endpoint focuses on balance movements and does not include fee or status details.
</Note>

## Response Fields

| Field     | Type   | Description                                     |
| --------- | ------ | ----------------------------------------------- |
| `entries` | array  | Array of up to 100 ledger entries, newest first |
| `count`   | number | Number of entries returned                      |

### Entry Fields

| Field           | Type   | Description                                                               |
| --------------- | ------ | ------------------------------------------------------------------------- |
| `transactionId` | string | Transaction batch ID (matches `transactionId` in `/account/transactions`) |
| `type`          | string | `CREDIT` or `DEBIT`                                                       |
| `amount`        | number | Amount in USD                                                             |
| `currency`      | string | Always `USD`                                                              |
| `description`   | string | Ledger description of the operation                                       |
| `balanceBefore` | number | Account balance before this entry (USD)                                   |
| `balanceAfter`  | number | Account balance after this entry (USD)                                    |
| `createdAt`     | string | ISO 8601 timestamp                                                        |

## Example Usage

```javascript theme={null}
const response = await fetch('https://api.fyatu.com/api/v3/account/statement', {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
});

const { data } = await response.json();

console.log(`Statement entries: ${data.count}`);
data.entries.forEach(entry => {
  console.log(`${entry.type}: $${entry.amount} — ${entry.description}`);
  console.log(`  Balance: $${entry.balanceBefore} → $${entry.balanceAfter}`);
});
```

## Use Cases

1. **Reconciliation**: Verify the exact balance before and after each operation
2. **Audit trail**: Confirm that every debit and credit is accounted for
3. **Balance verification**: Cross-check your current balance against the last ledger entry's `balanceAfter`


## OpenAPI

````yaml v3/openapi.json GET /account/statement
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/statement:
    get:
      tags:
        - Account
      summary: Get Statement
      description: >-
        Retrieve the last 100 ledger entries for your business account. Each
        entry includes the account balance before and after the operation,
        derived from the immutable double-entry ledger. Designed for accounting
        and reconciliation use cases.
      operationId: getStatement
      responses:
        '200':
          description: Statement retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatementResponse'
              example:
                success: true
                status: 200
                message: Statement retrieved successfully
                data:
                  count: 5
                  entries:
                    - transactionId: DEP69FE561280613
                      type: CREDIT
                      amount: 100
                      currency: USD
                      description: 'Admin: Deposit of 100 USD'
                      balanceBefore: 4.93
                      balanceAfter: 104.93
                      createdAt: '2026-05-08T21:30:58Z'
                    - transactionId: FYB69F984AA38EFB
                      type: DEBIT
                      amount: 30
                      currency: USD
                      description: Card Issuance | Alice Example
                      balanceBefore: 104.93
                      balanceAfter: 74.93
                      createdAt: '2026-05-05T09:00:00Z'
                    - transactionId: FYB69EE099B77FBB
                      type: CREDIT
                      amount: 26
                      currency: USD
                      description: Transfer received from Bob Example | B0024891
                      balanceBefore: 48.93
                      balanceAfter: 74.93
                      createdAt: '2026-04-26T12:48:27Z'
                    - transactionId: FYB69E67E1B227D5
                      type: DEBIT
                      amount: 5.5
                      currency: USD
                      description: Card Funding - 515253******1234 (Alice Example)
                      balanceBefore: 54.43
                      balanceAfter: 48.93
                      createdAt: '2026-04-26T16:25:51Z'
                    - transactionId: FYB696DED993A693
                      type: DEBIT
                      amount: 2
                      currency: USD
                      description: Unloading from 515253******1234 (Alice Example)
                      balanceBefore: 56.43
                      balanceAfter: 54.43
                      createdAt: '2026-04-20T19:27:23Z'
                meta:
                  requestId: req_7af4d2b8e91c35fa4b21890e
                  timestamp: '2026-05-08T21:55:06Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
      security:
        - BearerAuth: []
components:
  schemas:
    StatementResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        status:
          type: integer
          example: 200
        message:
          type: string
        data:
          type: object
          properties:
            entries:
              type: array
              items:
                type: object
                properties:
                  transactionId:
                    type: string
                  type:
                    type: string
                    enum:
                      - CREDIT
                      - DEBIT
                  amount:
                    type: number
                    format: float
                  currency:
                    type: string
                    example: USD
                  description:
                    type: string
                  balanceBefore:
                    type: number
                    format: float
                  balanceAfter:
                    type: number
                    format: float
                  createdAt:
                    type: string
                    format: date-time
            count:
              type: integer
        meta:
          $ref: '#/components/schemas/Meta'
    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'
    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

````