> ## 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. They belong to the organization that owns your API key, which must be a partner organization; a customer organization returns `403` `forbidden`.

Only closed months are listed. A month still open does not appear and its CSV and PDF return `404`. A closed month carries no amount until a payout is recorded, because the payout is converted at the rate on that day.



## OpenAPI

````yaml openapi-v2.json GET /partner_statements
openapi: 3.1.0
info:
  title: Etherfuse FX API
  description: >-
    Partner-facing ramp API, version 2: payment accounts, quotes, orders and
    webhooks.
  license:
    name: Proprietary
  version: 2.0.0
servers:
  - url: https://api.sand.etherfuse.com
    description: Sandbox
security:
  - ApiKeyAuth: []
tags:
  - name: Payment Accounts
    description: >-
      Register the bank accounts and wallets that money moves from and to, and
      read their readiness per rail.
  - name: Quotes
    description: Price a transfer between two registered payment accounts.
  - name: Orders
    description: Create orders from quotes and track them.
  - name: Webhook Subscriptions
    description: Subscribe to webhook events.
  - name: Webhook Events
    description: Payloads Etherfuse sends to your webhook subscriptions.
  - name: Sandbox
    description: Endpoints that work only in sandbox, for testing.
  - name: Assets
    description: The markets and tokens a quote can use, and the balances of a wallet.
  - name: Authentication
    description: >-
      Partner JWT authentication: exchange a JWT for an access token, or launch
      a user into the app.
  - 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: KYB
    description: Check where a business organization's KYB stands.
  - name: Lookup
    description: >-
      Public reference data: exchange rates, stablebonds, bond costs, country
      codes.
  - name: Organizations
    description: >-
      Your organization, your default partner fee, and the customer
      organizations you create.
  - name: Members
    description: >-
      The people who belong to a customer business organization and complete its
      KYB.
  - name: Statements
    description: >-
      Monthly revenue share statements for closed months, as a list or as a CSV
      or PDF download.
paths:
  /partner_statements:
    get:
      tags:
        - Statements
      summary: List partner statements
      description: >-
        Returns your monthly revenue share statements, newest first. They belong
        to the organization that owns your API key, which must be a partner
        organization; a customer organization returns `403` `forbidden`.


        Only closed months are listed. A month still open does not appear and
        its CSV and PDF return `404`. A closed month carries no amount until a
        payout is recorded, because the payout is converted at the rate on that
        day.
      operationId: v2ListPartnerStatements
      responses:
        '200':
          description: Your closed and paid statement months.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerStatementList'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    PartnerStatementList:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          description: Closed and paid months, newest first.
          items:
            $ref: '#/components/schemas/PartnerStatementEntry'
      example:
        items:
          - 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.
    Problem:
      type: object
      description: >-
        RFC 9457 problem details. Every v2 error uses this body with content
        type `application/problem+json`. `errors` is present only on
        `validation-error`. `required` and `missing` are present only on
        `registration-info-required`.
      required:
        - type
        - title
        - status
        - detail
        - instance
      properties:
        type:
          type: string
          format: uri
          description: >-
            `https://docs.etherfuse.com/ramp/v2/errors/` followed by the problem
            slug, for example
            `https://docs.etherfuse.com/ramp/v2/errors/quote-expired`. Switch on
            this value.
          example: https://docs.etherfuse.com/ramp/v2/errors/quote-expired
        title:
          type: string
          description: Short summary of the problem type.
          example: Quote expired
        status:
          type: integer
          description: The HTTP status code.
          example: 400
        detail:
          type: string
          description: Human-readable explanation of this occurrence. Do not parse it.
          example: >-
            quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not
            exist
        instance:
          type: string
          description: Unique identifier for this occurrence. Quote it to support.
          example: >-
            tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d
        errors:
          type: array
          description: Present on `validation-error`. One entry per invalid field.
          items:
            $ref: '#/components/schemas/FieldViolation'
        required:
          type: array
          description: >-
            Present on `registration-info-required`. Every registration field
            the route requires, as JSON Pointers into the request, for example
            `#/registrationInfo/taxId`.
          items:
            type: string
        missing:
          type: array
          description: >-
            Present on `registration-info-required`. The required fields you
            must still send, as JSON Pointers into the request.
          items:
            type: string
    FieldViolation:
      type: object
      required:
        - pointer
        - detail
      properties:
        pointer:
          type: string
          description: >-
            JSON Pointer to the field in the request, for example
            `#/accountDetails/clabe`.
          example: '#/accountDetails/clabe'
        detail:
          type: string
          description: What is wrong with the field.
          example: This field is required.
  responses:
    Unauthorized:
      description: >-
        `unauthorized`: the `Authorization` header is missing, not ASCII, or
        does not hold a valid API key.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Forbidden:
      description: '`forbidden`: your API key''s organization may not do this.'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    InternalError:
      description: >-
        `internal-error`: an unexpected error on our side. Retry with backoff,
        and quote `instance` to support if it persists.
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: API key sent in the Authorization header, with no `Bearer` prefix.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.