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

# List Treasury beneficiaries

> Lists reusable individual and business recipients that this tenant account can pay in AUD.

## What this endpoint does

Lists reusable individual and business recipients that this tenant account can pay in AUD.

## When to use it

Use it to select a recipient for a payout and confirm its BSB/account details and status.

## Before you call

Authenticate with an API key that can read this resource. Results are restricted to the tenant account bound to that key.

## Money and balance effect

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

## States and completion

Only an eligible active beneficiary can be used. Identity or screening state may require evidence or review before payout submission.

## Safe retries

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

Read [Beneficiaries and payouts](/treasury/beneficiaries-and-payouts) for the complete workflow.


## OpenAPI

````yaml /api-reference/openapi.json get /v1/treasury/beneficiaries
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/beneficiaries:
    get:
      tags:
        - Treasury
      summary: List Treasury beneficiaries
      description: >-
        Lists reusable individual and business recipients that this tenant
        account can pay in AUD. Use it to select a recipient for a payout and
        confirm its BSB/account details and status.
      operationId: TreasuryController2_beneficiaries_v1
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            id:
                              type: string
                              minLength: 1
                            clientId:
                              type: string
                              minLength: 1
                            externalReference:
                              type: string
                              minLength: 1
                            destination:
                              oneOf:
                                - type: object
                                  properties:
                                    type:
                                      type: string
                                      enum:
                                        - bank_account
                                    bsb:
                                      type: string
                                      pattern: ^\d{6}$
                                    accountNumber:
                                      type: string
                                      pattern: ^\d{1,9}$
                                    accountName:
                                      type: string
                                      minLength: 2
                                  required:
                                    - type
                                    - bsb
                                    - accountNumber
                                    - accountName
                            partyContext:
                              type: object
                              additionalProperties:
                                type: string
                            status:
                              type: string
                              enum:
                                - active
                                - inactive
                            createdAt:
                              type: string
                              format: date-time
                            updatedAt:
                              type: string
                              format: date-time
                            deactivatedAt:
                              type: string
                              format: date-time
                            type:
                              type: string
                              enum:
                                - individual
                            firstName:
                              type: string
                              minLength: 1
                            lastName:
                              type: string
                              minLength: 1
                            dateOfBirth:
                              type: string
                            address:
                              type: string
                              minLength: 1
                          required:
                            - id
                            - clientId
                            - externalReference
                            - destination
                            - status
                            - createdAt
                            - updatedAt
                            - type
                            - firstName
                            - lastName
                            - dateOfBirth
                            - address
                        - type: object
                          properties:
                            id:
                              type: string
                              minLength: 1
                            clientId:
                              type: string
                              minLength: 1
                            externalReference:
                              type: string
                              minLength: 1
                            destination:
                              oneOf:
                                - type: object
                                  properties:
                                    type:
                                      type: string
                                      enum:
                                        - bank_account
                                    bsb:
                                      type: string
                                      pattern: ^\d{6}$
                                    accountNumber:
                                      type: string
                                      pattern: ^\d{1,9}$
                                    accountName:
                                      type: string
                                      minLength: 2
                                  required:
                                    - type
                                    - bsb
                                    - accountNumber
                                    - accountName
                            partyContext:
                              type: object
                              additionalProperties:
                                type: string
                            status:
                              type: string
                              enum:
                                - active
                                - inactive
                            createdAt:
                              type: string
                              format: date-time
                            updatedAt:
                              type: string
                              format: date-time
                            deactivatedAt:
                              type: string
                              format: date-time
                            type:
                              type: string
                              enum:
                                - business
                            businessName:
                              type: string
                              minLength: 1
                            businessIdentity:
                              type: object
                              additionalProperties:
                                type: string
                          required:
                            - id
                            - clientId
                            - externalReference
                            - destination
                            - status
                            - createdAt
                            - updatedAt
                            - type
                            - businessName
                required:
                  - data
      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.

````