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

# List inflows

> Your settlements, matched and unmatched. Cursor-paginated. Payer identity is never returned — it is the payer’s PII.



## OpenAPI

````yaml /openapi.json get /v1/inflows
openapi: 3.0.0
info:
  title: Spendin Merchant API
  description: Cross-border remittance and financial services API
  version: '1.0'
  contact: {}
servers:
  - url: https://api.spendin.app
    description: Production
security:
  - api-key: []
tags: []
paths:
  /v1/inflows:
    get:
      tags:
        - inflows
      summary: List inflows
      description: >-
        Your settlements, matched and unmatched. Cursor-paginated. Payer
        identity is never returned — it is the payer’s PII.
      operationId: InflowsController_listInflows
      parameters:
        - name: cursor
          required: false
          in: query
          description: Pagination cursor
          schema:
            type: string
        - name: limit
          required: false
          in: query
          description: Page size (1–100, default 20)
          schema:
            type: number
      responses:
        '200':
          description: Paginated inflow list
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/InflowResponseDto'
                  meta:
                    $ref: '#/components/schemas/PaginationMetaDto'
      security:
        - api-key: []
components:
  schemas:
    InflowResponseDto:
      type: object
      properties:
        id:
          type: string
          example: a3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d
        rail:
          type: string
          enum:
            - CRYPTO
            - BANK_TRANSFER
          example: CRYPTO
        provider_name:
          type: string
          example: USDT (TRC-20)
        network:
          type: object
          example: TRC20
          nullable: true
        amount:
          type: number
          example: 42.32
        currency:
          type: string
          example: USDT
        confirmations_received:
          type: object
          example: 20
          nullable: true
        is_matched:
          type: boolean
          example: true
        matched_at:
          type: object
          example: '2026-08-10T09:42:00.000Z'
          nullable: true
        payout_id:
          type: object
          example: b7e2d1a0-3c4b-4d5e-9f80-1a2b3c4d5e6f
          nullable: true
        is_underpaid:
          type: boolean
          example: false
          description: 'Held: does not cover any open instruction'
        overpayment_amount:
          type: number
          example: 0
        overpayment_currency:
          type: object
          example: USDT
          nullable: true
        created_at:
          type: string
          example: '2026-08-10T09:41:55.000Z'
      required:
        - id
        - rail
        - provider_name
        - network
        - amount
        - currency
        - confirmations_received
        - is_matched
        - matched_at
        - payout_id
        - is_underpaid
        - overpayment_amount
        - overpayment_currency
        - created_at
    PaginationMetaDto:
      type: object
      properties:
        next_cursor:
          type: object
          example: eyJpZCI6IjEyMyJ9
          nullable: true
        has_more:
          type: boolean
          example: true
        limit:
          type: number
          example: 20
      required:
        - next_cursor
        - has_more
        - limit
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key

````