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

# Search Treasury transactions

> Returns cursor-paginated wallet movements enriched with their operation kind, operation state, and external reference when available.

## What this endpoint does

Returns cursor-paginated wallet movements enriched with their operation kind, operation state, and external reference when available.

## When to use it

Use it for transaction history, balance reconciliation, and investigation without exposing beneficiary bank details or saved wallet addresses.

## Before you call

Authenticate with `treasury:read`. Filter by movement kind, operation status, external reference, or an ISO 8601 date range; pass `nextCursor` unchanged to read the next page.

## Money and balance effect

This is a read-only request. It does not reserve, debit, credit, or settle money.

## States and completion

A transaction is an immutable wallet effect, while its linked operation can still be in progress. Reconcile the movement and operation state together.

## Safe retries

GET requests are read-only and may be retried with normal exponential backoff. Do not send an `Idempotency-Key`.

Read [Operations and reconciliation](/treasury/operations-and-reconciliation) for the complete workflow.


## OpenAPI

````yaml /api-reference/openapi.json get /v1/treasury/transactions
openapi: 3.0.0
info:
  title: Wayex API
  description: >-
    Wayex APIs for direct customer payment routes and isolated, prefunded
    Treasury accounts. Each API key is bound to one tenant account and its own
    wallet, settings, webhooks, and reporting.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.sandbox.wayex.com
    description: Sandbox integration environment
security:
  - Bearer: []
  - ApiKey: []
tags:
  - name: Treasury
    description: >-
      Prefunded AUD and stablecoin wallets for one isolated tenant account.
      Fund, pay, convert, withdraw, track, and reconcile without selecting
      another account.
  - name: Customers
    description: >-
      Onboard end customers, run verification, and manage each customer's
      entitlements.
  - name: Payment routes
    description: >-
      Standing deposit instructions per customer. When a customer funds a route,
      Wayex auto-converts at the live rate and pays out/sends — no quote, no
      lock.
  - name: Transfers
    description: >-
      Read the conversion records produced when customers fund payment routes —
      the live activity feed and per-conversion lifecycle timeline.
  - name: Rates
    description: >-
      The live indicative AUD↔stablecoin rate right now — the all-in rate Wayex
      quotes. Indicative only; the binding price is struck when a route's funds
      land.
  - name: Revenue
    description: Your developer-fee revenue over time.
  - name: Invoices
    description: >-
      Your monthly invoices — Wayex platform fees due, net of your accrued
      developer-fee credit.
  - name: Webhooks
    description: Subscribe to HMAC-signed event webhooks and inspect deliveries.
  - name: API keys
    description: Create, list, and rotate API keys for programmatic access.
  - name: Fees
    description: >-
      Configure your developer fee — the markup withheld from each conversion
      and credited against your monthly invoice.
  - name: Invitations
    description: Accept a team invitation and activate your account.
paths:
  /v1/treasury/transactions:
    get:
      tags:
        - Treasury
      summary: Search Treasury transactions
      description: >-
        Returns cursor-paginated wallet movements enriched with their operation
        kind, operation state, and external reference when available. Use it for
        transaction history, balance reconciliation, and investigation without
        exposing beneficiary bank details or saved wallet addresses.
      operationId: TreasuryController2_transactionReport_v1
      parameters:
        - name: limit
          required: false
          in: query
          schema:
            example: 25
            type: number
        - name: cursor
          required: false
          in: query
          schema:
            type: string
        - name: to
          required: false
          in: query
          schema:
            type: string
            format: date-time
        - name: from
          required: false
          in: query
          schema:
            type: string
            format: date-time
        - name: status
          required: false
          in: query
          schema:
            enum:
              - accepted
              - held
              - submitted
              - settled
              - failed
              - returned
            type: string
        - name: kind
          required: false
          in: query
          schema:
            type: string
            enum:
              - funding_credited
              - funding_returned
              - admin_adjustment
              - payout_reserved
              - withdrawal_reserved
              - conversion_reserved
              - conversion_credited
              - reservation_released
              - reservation_captured
              - late_execution_debited
              - funding_hold_released
              - payout_returned
        - name: externalReference
          required: false
          in: query
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          minLength: 1
                        clientId:
                          type: string
                          minLength: 1
                        asset:
                          type: string
                          enum:
                            - AUD
                            - USDC
                            - USDT
                        kind:
                          type: string
                          enum:
                            - funding_credited
                            - funding_returned
                            - admin_adjustment
                            - payout_reserved
                            - withdrawal_reserved
                            - conversion_reserved
                            - conversion_credited
                            - reservation_released
                            - reservation_captured
                            - late_execution_debited
                            - funding_hold_released
                            - payout_returned
                        availableDelta:
                          type: string
                          pattern: ^-?\d+(\.\d+)?$
                        reservedDelta:
                          type: string
                          pattern: ^-?\d+(\.\d+)?$
                        reference:
                          type: string
                          minLength: 1
                        reason:
                          type: string
                          minLength: 1
                        occurredAt:
                          type: string
                          format: date-time
                        externalReference:
                          type: string
                          minLength: 1
                        operationId:
                          type: string
                          minLength: 1
                        operationKind:
                          enum:
                            - payout
                            - stable_withdrawal
                            - conversion
                          type: string
                        operationStatus:
                          enum:
                            - accepted
                            - held
                            - submitted
                            - settled
                            - failed
                            - returned
                          type: string
                      required:
                        - id
                        - clientId
                        - asset
                        - kind
                        - availableDelta
                        - reservedDelta
                        - reference
                        - occurredAt
                        - externalReference
                  hasMore:
                    type: boolean
                  nextCursor:
                    type: string
                    minLength: 1
                    nullable: true
                required:
                  - data
                  - hasMore
                  - nextCursor
      security:
        - Bearer: []
        - ApiKey: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: Wayex API key
      description: 'Send the same Wayex API key as `Authorization: Bearer <key>`.'
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: A Wayex API key. Use a secret key for write operations.

````