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

> Returns a cursor-paginated view across this tenant account’s payouts, conversions, and stablecoin withdrawals.

## What this endpoint does

Returns a cursor-paginated view across this tenant account’s payouts, conversions, and stablecoin withdrawals.

## When to use it

Use it to operate a queue, filter lifecycle states, or recover an operation by `externalReference` after a create response was lost.

## Before you call

Authenticate with `treasury:read`. Filter by operation kind, status, external reference, or an ISO 8601 date range; cursors belong to the exact filtered result set.

## Money and balance effect

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

## States and completion

Each row reports the current operation state and next action. `accepted`, `held`, and `submitted` do not prove external settlement; open the resource detail before acting.

## 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/operations
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/operations:
    get:
      tags:
        - Treasury
      summary: Search Treasury operations
      description: >-
        Returns a cursor-paginated view across this tenant account’s payouts,
        conversions, and stablecoin withdrawals. Use it to operate a queue,
        filter lifecycle states, or recover an operation by `externalReference`
        after a create response was lost.
      operationId: TreasuryController2_operationReport_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:
            enum:
              - payout
              - stable_withdrawal
              - conversion
            type: string
        - 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
                        kind:
                          enum:
                            - payout
                            - stable_withdrawal
                            - conversion
                          type: string
                        status:
                          enum:
                            - accepted
                            - held
                            - submitted
                            - settled
                            - failed
                            - returned
                          type: string
                        source:
                          type: object
                          properties:
                            amount:
                              type: string
                              pattern: ^\d+(\.\d+)?$
                            currency:
                              type: string
                              enum:
                                - AUD
                                - USDC
                                - USDT
                            network:
                              type: string
                              enum:
                                - ethereum
                                - base
                                - arbitrum
                                - optimism
                                - polygon
                                - bsc
                                - avalanche
                                - solana
                                - tron
                          required:
                            - amount
                            - currency
                        destination:
                          type: object
                          properties:
                            amount:
                              type: string
                              pattern: ^\d+(\.\d+)?$
                            currency:
                              type: string
                              enum:
                                - AUD
                                - USDC
                                - USDT
                            network:
                              type: string
                              enum:
                                - ethereum
                                - base
                                - arbitrum
                                - optimism
                                - polygon
                                - bsc
                                - avalanche
                                - solana
                                - tron
                          required:
                            - amount
                            - currency
                        fee:
                          type: object
                          properties:
                            amount:
                              type: string
                              pattern: ^\d+(\.\d+)?$
                            currency:
                              type: string
                              enum:
                                - AUD
                                - USDC
                                - USDT
                            network:
                              type: string
                              enum:
                                - ethereum
                                - base
                                - arbitrum
                                - optimism
                                - polygon
                                - bsc
                                - avalanche
                                - solana
                                - tron
                          required:
                            - amount
                            - currency
                        sourceDebit:
                          type: object
                          properties:
                            amount:
                              type: string
                              pattern: ^\d+(\.\d+)?$
                            currency:
                              type: string
                              enum:
                                - AUD
                                - USDC
                                - USDT
                            network:
                              type: string
                              enum:
                                - ethereum
                                - base
                                - arbitrum
                                - optimism
                                - polygon
                                - bsc
                                - avalanche
                                - solana
                                - tron
                          required:
                            - amount
                            - currency
                        configurationId:
                          type: string
                          minLength: 1
                        externalReference:
                          type: string
                          minLength: 1
                        providerReference:
                          type: string
                          minLength: 1
                        statusReason:
                          type: string
                          minLength: 1
                        reservation:
                          type: object
                          properties:
                            status:
                              type: string
                              enum:
                                - reserved
                                - captured
                                - released
                            amount:
                              type: object
                              properties:
                                amount:
                                  type: string
                                  pattern: ^\d+(\.\d+)?$
                                currency:
                                  type: string
                                  enum:
                                    - AUD
                                    - USDC
                                    - USDT
                                network:
                                  type: string
                                  enum:
                                    - ethereum
                                    - base
                                    - arbitrum
                                    - optimism
                                    - polygon
                                    - bsc
                                    - avalanche
                                    - solana
                                    - tron
                              required:
                                - amount
                                - currency
                          required:
                            - status
                            - amount
                        nextAction:
                          type: string
                          enum:
                            - none
                            - wait_for_settlement
                            - contact_support
                            - retry_new_request
                            - review_balance
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
                      required:
                        - id
                        - clientId
                        - kind
                        - status
                        - source
                        - fee
                        - sourceDebit
                        - configurationId
                        - externalReference
                        - reservation
                        - nextAction
                        - createdAt
                        - updatedAt
                  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.

````