> ## 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 outflows for a payout

> Every dispatch attempt, oldest first. Rows are immutable — a retry adds a new row rather than overwriting a failed one.



## OpenAPI

````yaml /openapi.json get /v1/payouts/{payout_id}/outflows
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/payouts/{payout_id}/outflows:
    get:
      tags:
        - outflows
      summary: List outflows for a payout
      description: >-
        Every dispatch attempt, oldest first. Rows are immutable — a retry adds
        a new row rather than overwriting a failed one.
      operationId: OutflowsController_listForPayout
      parameters:
        - name: payout_id
          required: true
          in: path
          schema:
            format: uuid
            type: string
      responses:
        '200':
          description: Outflow attempts
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OutflowResponseDto'
      security:
        - api-key: []
components:
  schemas:
    OutflowResponseDto:
      type: object
      properties:
        id:
          type: string
          example: c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f
        payout_id:
          type: string
          example: b7e2d1a0-3c4b-4d5e-9f80-1a2b3c4d5e6f
        processor:
          type: string
          example: neona
        status:
          type: string
          enum:
            - PENDING
            - PROCESSING
            - SUCCESSFUL
            - FAILED
          example: PROCESSING
        attempt_number:
          type: number
          example: 1
          description: Increments per retry — each attempt is its own row
        destination_amount:
          type: number
          example: 500
        destination_currency:
          type: string
          example: GHS
        processor_reference:
          type: object
          example: FLW-TX-00112
          nullable: true
        failure_reason:
          type: object
          example: null
          nullable: true
        failure_code:
          type: object
          example: null
          nullable: true
        dispatched_at:
          type: object
          example: '2026-08-10T09:45:00.000Z'
          nullable: true
        settled_at:
          type: object
          example: null
          nullable: true
        created_at:
          type: string
          example: '2026-08-10T09:44:58.000Z'
      required:
        - id
        - payout_id
        - processor
        - status
        - attempt_number
        - destination_amount
        - destination_currency
        - processor_reference
        - failure_reason
        - failure_code
        - dispatched_at
        - settled_at
        - created_at
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key

````