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

# List partner statements

> Returns your monthly revenue share statements, newest first. The organization comes from your API key.

Only closed months are listed. A month still open does not appear and its CSV and PDF return 404, so the month in progress is never visible. A closed month carries no amount until a payout is recorded, because the payout is converted at a rate struck at that time.



## OpenAPI

````yaml /openapi.json get /ramp/partner-statements
openapi: 3.1.0
info:
  title: Etherfuse FX API
  description: Partner-facing ramp API for onramps, offramps, swaps, and KYC.
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sand.etherfuse.com
    description: Sandbox
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: >-
      Partner JWT authentication — exchange a JWT for an access token, or launch
      a user into the app.
  - name: Lookup
    description: >-
      Public reference data: exchange rates, stablebonds, bond costs, country
      codes.
  - name: Assets
    description: Rampable stablecoins and stablebonds available per blockchain.
  - name: Bank Accounts
    description: Register and retrieve customer bank accounts.
  - name: Quotes
    description: Price quotes for onramps, offramps, and swaps.
  - name: Orders
    description: Create, track, and manage ramp orders.
  - name: Swaps
    description: Crypto-to-crypto swaps.
  - name: Sponsored
    description: Token approvals for sponsored (gasless) offramps.
  - name: Customers
    description: Customer (child-organization) records.
  - name: Wallets
    description: Register and manage customer wallets.
  - name: KYC
    description: >-
      Submit a customer's verification data, documents and questionnaire
      answers, import a verification they already passed elsewhere, and check
      where their KYC stands.
  - name: Webhooks
    description: Event notification subscriptions.
  - name: Organizations
    description: Organization identity, child orgs, and partner fees.
  - name: Statements
    description: >-
      Monthly revenue share statements for closed months, as a list or as a CSV
      or PDF download.
  - name: Deprecated
    description: >-
      Endpoints kept working until their sunset date and then removed. See the
      deprecations page for replacements and dates.
paths:
  /ramp/partner-statements:
    get:
      tags:
        - Statements
      summary: List partner statements
      description: >-
        Returns your monthly revenue share statements, newest first. The
        organization comes from your API key.


        Only closed months are listed. A month still open does not appear and
        its CSV and PDF return 404, so the month in progress is never visible. A
        closed month carries no amount until a payout is recorded, because the
        payout is converted at a rate struck at that time.
      operationId: api_list_statements
      responses:
        '200':
          description: Your closed and paid statement months
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerStatementListResponse'
        '403':
          description: Statements are issued to the parent organization
components:
  schemas:
    PartnerStatementListResponse:
      type: object
      required:
        - statements
      properties:
        statements:
          type: array
          description: Closed and paid months, newest first.
          items:
            $ref: '#/components/schemas/PartnerStatementEntry'
      example:
        statements:
          - periodYear: 2026
            periodMonth: 6
            status: closed
            closedAt: '2026-07-04T17:42:10.427124+00:00'
            paidAt: null
            payoutTotal: null
            payoutCurrency: null
          - periodYear: 2026
            periodMonth: 5
            status: paid
            closedAt: '2026-06-04T17:42:10.427124+00:00'
            paidAt: '2026-06-09T17:42:10.427124+00:00'
            payoutTotal: '1543.22'
            payoutCurrency: USDC
    PartnerStatementEntry:
      type: object
      description: One closed month of revenue share. Open months are never returned.
      required:
        - periodYear
        - periodMonth
        - status
        - closedAt
        - paidAt
        - payoutTotal
        - payoutCurrency
      properties:
        periodYear:
          type: integer
          description: Four digit statement year.
        periodMonth:
          type: integer
          minimum: 1
          maximum: 12
          description: Statement month, 1 through 12, not zero padded.
        status:
          type: string
          enum:
            - closed
            - paid
          description: >-
            `closed` once the month is frozen, `paid` once a payout is recorded.
            Open months are not listed. Treat as an open set; new values may be
            added.
        closedAt:
          type: string
          format: date-time
          nullable: true
          description: When the month was frozen, RFC 3339.
        paidAt:
          type: string
          format: date-time
          nullable: true
          description: When the payout was recorded, RFC 3339. Null until then.
        payoutTotal:
          type: string
          nullable: true
          description: >-
            Amount paid out. A decimal string with two fractional digits,
            truncated toward zero, matching the CSV and PDF. Null until a payout
            is recorded, and for a month that settled at zero.
        payoutCurrency:
          type: string
          enum:
            - USDC
            - USDT
            - USD
            - MXN
          nullable: true
          description: Currency the payout settled in. Null until a payout is recorded.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: API key sent in the Authorization header.

````