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

# List statements

> Lists statements requested for the project, most recently created first, including those Reap produces on a schedule.



## OpenAPI

````yaml /api-reference/openapi.json get /statements/
openapi: 3.1.0
info:
  title: Reap API
  version: 1.0.0
  description: Reap platform API
servers:
  - url: https://sg.sandbox.api.reap.global
    description: Singapore sandbox
  - url: https://sg.prod.api.reap.global
    description: Singapore production
  - url: https://mx.sandbox.api.reap.global
    description: Mexico sandbox
  - url: https://mx.prod.api.reap.global
    description: Mexico production
  - url: https://sandbox.api.reap.global
    description: Singapore sandbox (alias)
  - url: https://prod.api.reap.global
    description: Singapore production (alias)
security:
  - bearerAuth: []
tags:
  - name: Accounts
  - name: Activities
  - name: Card Designs
  - name: Card Shipments
  - name: Card Transactions
  - name: Cards
  - name: Companies
  - name: Crypto Deposits
  - name: Crypto Withdrawals
  - name: Disputes
  - name: Fees
  - name: Fiat Deposits
  - name: Fraud Alerts
  - name: Policies
  - name: Simulation
  - name: Statements
  - name: Users
  - name: Virtual Asset Postings
  - name: Virtual Assets
  - name: Webhooks
  - name: Agentic
paths:
  /statements/:
    get:
      tags:
        - Statements
      summary: List statements
      description: >-
        Lists statements requested for the project, most recently created first,
        including those Reap produces on a schedule.
      operationId: list_statements
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            default: 20
            examples:
              - 20
              - 50
              - 100
            description: 'Maximum number of items to return (1-100, default: 20)'
            type: integer
            exclusiveMinimum: 0
            maximum: 100
        - name: cursor
          in: query
          required: false
          schema:
            description: >-
              Opaque cursor for pagination. Pass nextCursor from previous
              response to get next page.
            type: string
        - name: type
          in: query
          required: false
          schema:
            description: Filter by statement type. Comma-separated for several.
            type: array
            items:
              type: string
              enum:
                - CARD_TRANSACTION_FEES
                - CARD_NON_TRANSACTION_FEES
              description: >-
                - `CARD_TRANSACTION_FEES`: One row per card transaction cost
                event: settlements, authorizations, refunds and token events
                with their billed amounts, FX and ATM markups and interchange

                - `CARD_NON_TRANSACTION_FEES`: One row per card fee occurrence
                not tied to a transaction: card creation, maintenance and wallet
                provisioning fees
              example: CARD_TRANSACTION_FEES
        - name: status
          in: query
          required: false
          schema:
            description: Filter by status. Comma-separated for several.
            type: array
            items:
              type: string
              enum:
                - PENDING
                - GENERATED
                - FAILED
              description: >-
                - `PENDING`: Requested; the file is being produced

                - `GENERATED`: The file is ready to download

                - `FAILED`: The file could not be produced. Request the
                statement again
              example: PENDING
        - name: origin
          in: query
          required: false
          schema:
            description: >-
              Filter by who requested the statement. Comma-separated for
              several.
            type: array
            items:
              type: string
              enum:
                - CLIENT
                - REAP
              description: >-
                - `CLIENT`: Requested by the client through the API

                - `REAP`: Produced by Reap on a schedule, such as the monthly
                statement backing an invoice
              example: CLIENT
        - name: periodFrom
          in: query
          required: false
          schema:
            description: Only statements whose period starts on or after this day
            type: string
            format: date
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
        - name: periodTo
          in: query
          required: false
          schema:
            description: Only statements whose period ends on or before this day
            type: string
            format: date
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
        - name: Reap-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2025-02-14'
            description: API version (YYYY-MM-DD)
            example: '2025-02-14'
      responses:
        '200':
          description: Response for status 200
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Statement'
                      description: Statement resource
                  nextCursor:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Cursor for next page, or null if no more items
                required:
                  - items
                  - nextCursor
components:
  schemas:
    Statement:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique statement identifier
        type:
          type: string
          enum:
            - CARD_TRANSACTION_FEES
            - CARD_NON_TRANSACTION_FEES
          description: What the statement itemises
          example: CARD_TRANSACTION_FEES
        origin:
          type: string
          enum:
            - CLIENT
            - REAP
          description: Who requested the statement
          example: CLIENT
        status:
          type: string
          enum:
            - PENDING
            - GENERATED
            - FAILED
          description: Current statement status
          example: PENDING
        period:
          $ref: '#/components/schemas/StatementPeriod'
        fields:
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          examples:
            - - occurredAt
              - transactionId
              - billAmount
          description: >-
            Columns in the file, in order. `null` means every column of the
            type.
        format:
          type: string
          enum:
            - CSV
          description: File format
          example: CSV
        version:
          type: string
          examples:
            - '2025-02-14'
          description: >-
            API version the statement was requested under. Fixes the column
            definitions the file follows.
        rowCount:
          anyOf:
            - type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
            - type: 'null'
          examples:
            - 1842
          description: Number of data rows in the file, once generated
        byteSize:
          anyOf:
            - type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
            - type: 'null'
          examples:
            - 412034
          description: Size of the file in bytes, once generated
        dataAsOf:
          anyOf:
            - type: string
            - type: 'null'
          examples:
            - '2025-04-02T03:15:00Z'
          description: >-
            ISO 8601 timestamp of how fresh the source data was when the file
            was produced, when known
        generatedAt:
          anyOf:
            - type: string
            - type: 'null'
          examples:
            - '2025-04-02T03:20:12Z'
          description: ISO 8601 timestamp of when the file became available
        createdAt:
          type: string
          examples:
            - '2025-04-02T03:20:00Z'
          description: ISO 8601 timestamp of creation
        updatedAt:
          type: string
          examples:
            - '2025-04-02T03:20:12Z'
          description: ISO 8601 timestamp of last update
      required:
        - id
        - type
        - origin
        - status
        - period
        - fields
        - format
        - version
        - rowCount
        - byteSize
        - dataAsOf
        - generatedAt
        - createdAt
        - updatedAt
    StatementPeriod:
      type: object
      properties:
        from:
          type: string
          format: date
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
          examples:
            - '2025-03-01'
          description: First calendar day covered, inclusive, UTC
        to:
          type: string
          format: date
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
          examples:
            - '2025-03-31'
          description: Last calendar day covered, inclusive, UTC
      required:
        - from
        - to
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key as Bearer token

````