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

# List Transactions

> A filtered read-model over Payout, projected to date / to-from / amount / account / derived-method / status, newest-first and paged by cursor. Narrow with any of beneficiary_id, status, and from/to date bounds (they compose); results are scoped to the caller's Business and environment, so a foreign id yields an empty list.



## OpenAPI

````yaml GET /v1/reporting/transactions
openapi: 3.0.0
info:
  title: Cleff API
  description: >-
    Payout orchestration platform. All endpoints under /v1/ require an API key
    in the Authorization header (Bearer ck_<env>_<id>_<secret>).
  version: 0.0.1
  contact: {}
servers: []
security: []
tags: []
paths:
  /v1/reporting/transactions:
    get:
      tags:
        - Reporting
      summary: List the Transactions ledger for the current Business and environment
      description: >-
        A filtered read-model over Payout, projected to date / to-from / amount
        / account / derived-method / status, newest-first and paged by cursor.
        Narrow with any of beneficiary_id, status, and from/to date bounds (they
        compose); results are scoped to the caller's Business and environment,
        so a foreign id yields an empty list.
      operationId: TransactionsController_list
      parameters:
        - name: beneficiary_id
          required: false
          in: query
          schema:
            type: string
        - name: limit
          required: false
          in: query
          schema:
            type: number
        - name: cursor
          required: false
          in: query
          schema:
            type: string
        - name: status
          required: false
          in: query
          schema:
            type: string
            enum:
              - pending_approval
              - approved
              - rejected
              - disbursed
              - failed
              - returned
              - canceled
              - settled
              - compliance_hold
        - name: from
          required: false
          in: query
          description: >-
            Inclusive lower bound on the transaction date (ISO-8601 date or
            timestamp).
          schema:
            type: string
        - name: to
          required: false
          in: query
          description: >-
            Inclusive upper bound on the transaction date (ISO-8601 date or
            timestamp). A date-only value covers the whole day.
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListTransactionsResponseDto'
        '401':
          description: Missing or invalid credentials
      security:
        - api_key: []
components:
  schemas:
    ListTransactionsResponseDto:
      type: object
      properties:
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/TransactionDto'
        next_cursor:
          type: string
          nullable: true
          description: >-
            Opaque cursor for the next (older) page — the id of the last row
            returned — or null on the last page. Pass it back as ?cursor= to
            fetch the next page.
      required:
        - transactions
        - next_cursor
    TransactionDto:
      type: object
      properties:
        id:
          type: string
          description: The underlying Payout or Deposit id.
        type:
          type: string
          enum:
            - payout
            - deposit
          description: >-
            payout = money out; deposit = a funding deposit into the dedicated
            account.
        created_at:
          type: string
          format: date-time
          description: >-
            Initiation date (Payout.created_at, or when the deposit landed) —
            always present, including for unsettled rows.
        beneficiary_id:
          type: string
          nullable: true
          description: Null on a deposit row.
        beneficiary_name:
          type: string
          nullable: true
          description: To/From — the beneficiary name.
        amount_minor:
          type: number
          description: Amount in minor units.
        currency:
          type: string
        account_label:
          type: string
          nullable: true
          description: >-
            Masked destination account, e.g. ••5988. Null when the account is
            unknown.
        method:
          type: string
          enum:
            - ach
            - international_wire
          nullable: true
          description: >-
            Derived corridor label — not stored, and not the network that
            carried the payment. Null on a deposit row.
        status:
          type: string
          enum:
            - pending_approval
            - approved
            - rejected
            - disbursed
            - failed
            - returned
            - canceled
            - settled
            - compliance_hold
          nullable: true
          description: >-
            Payout state, rendered with PayoutStatusBadge. Null on a deposit
            row.
      required:
        - id
        - type
        - created_at
        - beneficiary_id
        - beneficiary_name
        - amount_minor
        - currency
        - account_label
        - method
        - status
  securitySchemes:
    api_key:
      scheme: bearer
      bearerFormat: ck_<env>_<id>_<secret>
      type: http
      description: >-
        Cleff API key issued to a Business that self-registers via POST
        /v1/registration

````