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

> Lists invoices issued to the current tenant account.

## What this endpoint does

Lists invoices issued to the current tenant account.

## When to use it

Use it to reconcile billing periods, platform fees, developer-fee credits, and payment 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

Read each invoice status before treating it as paid or final. Open the invoice for its line-item detail.

## Safe retries

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

Read [Revenue and invoices](/console/activity) for the complete workflow.


## OpenAPI

````yaml /api-reference/openapi.json get /v1/invoices
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/invoices:
    get:
      tags:
        - Invoices
      summary: List invoices
      description: >-
        Lists invoices issued to the current tenant account. Use it to reconcile
        billing periods, platform fees, developer-fee credits, and payment
        status.
      operationId: InvoicesController2_list_v1
      parameters:
        - name: status
          required: true
          in: query
          schema:
            type: string
        - name: cursor
          required: true
          in: query
          schema:
            type: string
        - name: limit
          required: true
          in: query
          schema:
            type: string
      responses:
        '200':
          description: A cursor-paginated page of your invoices.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: The page of results, newest first.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          minLength: 1
                        number:
                          type: string
                          pattern: ^INV-\d{6}-\d{4}$
                        counterpartyId:
                          type: string
                          minLength: 1
                        periodFrom:
                          type: string
                          format: date-time
                        periodTo:
                          type: string
                          format: date-time
                        status:
                          type: string
                          enum:
                            - draft
                            - issued
                            - settled
                            - void
                        currency:
                          type: string
                          enum:
                            - AUD
                        lines:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - kyc
                                  - kyb
                                  - virtual_account
                                  - transfer
                                  - developer_credit
                                  - tax
                              description:
                                type: string
                                minLength: 1
                              count:
                                type: integer
                                minimum: 0
                                exclusiveMinimum: false
                              amount:
                                type: string
                                pattern: ^-?\d+(\.\d+)?$
                              amountMinor:
                                type: string
                                pattern: ^-?\d+$
                            required:
                              - type
                              - description
                              - count
                              - amount
                              - amountMinor
                        platformFeesDue:
                          type: string
                          pattern: ^-?\d+(\.\d+)?$
                        platformFeesDueMinor:
                          type: string
                          pattern: ^-?\d+$
                        developerFeesCredit:
                          type: string
                          pattern: ^-?\d+(\.\d+)?$
                        developerFeesCreditMinor:
                          type: string
                          pattern: ^-?\d+$
                        tax:
                          type: string
                          pattern: ^\d+(\.\d+)?$
                        taxMinor:
                          type: string
                          pattern: ^\d+$
                        netDue:
                          type: string
                          pattern: ^-?\d+(\.\d+)?$
                        netDueMinor:
                          type: string
                          pattern: ^-?\d+$
                        inflowCollected:
                          type: array
                          items:
                            type: object
                            properties:
                              asset:
                                type: string
                                enum:
                                  - AUD
                                  - USDC
                                  - USDT
                              amount:
                                type: string
                                pattern: ^\d+(\.\d+)?$
                              amountMinor:
                                type: string
                                pattern: ^\d+$
                              count:
                                type: integer
                                minimum: 0
                                exclusiveMinimum: false
                            required:
                              - asset
                              - amount
                              - amountMinor
                              - count
                        generatedAt:
                          type: string
                          format: date-time
                        generatedBy:
                          type: string
                          minLength: 1
                        issuedAt:
                          type: string
                          format: date-time
                        issuedBy:
                          type: string
                          minLength: 1
                        settledAt:
                          type: string
                          format: date-time
                        settledBy:
                          type: string
                          minLength: 1
                        voidedAt:
                          type: string
                          format: date-time
                        voidedBy:
                          type: string
                          minLength: 1
                      required:
                        - id
                        - number
                        - counterpartyId
                        - periodFrom
                        - periodTo
                        - status
                        - currency
                        - lines
                        - platformFeesDue
                        - platformFeesDueMinor
                        - developerFeesCredit
                        - developerFeesCreditMinor
                        - tax
                        - taxMinor
                        - netDue
                        - netDueMinor
                        - inflowCollected
                        - generatedAt
                        - generatedBy
                  hasMore:
                    type: boolean
                    description: Whether a further page exists after this one.
                  nextCursor:
                    type: string
                    nullable: true
                    description: >-
                      Opaque cursor to pass as `cursor` to fetch the next page,
                      or null at the end.
                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.

````