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

# List Onboarding Transfers

View all transfers associated with a specific onboarding. Useful to track the complete transfer chain, including reversals.

## Response Format

* Returns an array of `onboardingTransferResponse` objects
* Ordered by `created_at` DESC (most recent first)
* Includes transfers where onboarding is either origin or destination
* Empty array `[]` if no transfers found


## OpenAPI

````yaml openapi/recipients-for-marketplace/get-transfers/list-onboarding-transfers.json GET /onboardings/{onboarding_id}/transfers
openapi: 3.1.0
info:
  title: Recipients API
  version: 1.0.0
  description: >-
    API for managing recipients in split payment scenarios. This feature enables
    merchants to split payments among multiple recipients, which is particularly
    beneficial for marketplace models where transactions need to be divided
    among different sellers or stakeholders.
servers:
  - url: https://api-sandbox.y.uno/v1
security:
  - sec0: []
    sec1: []
paths:
  /onboardings/{onboarding_id}/transfers:
    get:
      operationId: get_onboardings-onboarding-id-transfers
      parameters:
        - in: path
          name: onboarding_id
          schema:
            type: string
          required: true
          description: >-
            The onboarding `id` returned from the [create
            onboarding](/reference/create-onboarding) endpoint (UUID).
        - in: header
          name: x-account-code
          schema:
            type: string
          description: >-
            The `account_id` found in your [Yuno
            Dashboard](https://dashboard.y.uno/developers) (UUID).
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                'OK: Array of transfers (by most recent)':
                  summary: 'OK: Array of transfers (by most recent)'
                  value:
                    - id: 550e8400-e29b-41d4-a716-446655440000
                      origin_onboarding:
                        id: 660e8400-e29b-41d4-a716-446655440001
                        status: TRANSFERRED
                        type: ONE_STEP_ONBOARDING
                        workflow: DIRECT
                        provider:
                          id: STRIPE
                          recipient_id: acct_1234567890
                          connection_id: 880e8400-e29b-41d4-a716-446655440003
                        recipient:
                          id: 770e8400-e29b-41d4-a716-446655440002
                          merchant_recipient_id: seller-123
                          email: seller@example.com
                        created_at: '2026-01-15T10:00:00Z'
                        updated_at: '2026-01-15T16:59:22Z'
                      destination_onboarding:
                        id: 990e8400-e29b-41d4-a716-446655440004
                        status: SUCCEEDED
                        type: ONE_STEP_ONBOARDING
                        provider:
                          id: STRIPE
                          recipient_id: acct_0987654321
                          connection_id: 880e8400-e29b-41d4-a716-446655440003
                        recipient:
                          id: aa0e8400-e29b-41d4-a716-446655440005
                          merchant_recipient_id: seller-456
                          email: newseller@example.com
                        created_at: '2026-01-15T16:59:22Z'
                        updated_at: '2026-01-15T16:59:23Z'
                      created_at: '2026-01-15T16:59:22.996009Z'
                      updated_at: '2026-01-15T16:59:23.734739Z'
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      example: 550e8400-e29b-41d4-a716-446655440000
                    origin_onboarding:
                      type: object
                      properties:
                        id:
                          type: string
                          example: 660e8400-e29b-41d4-a716-446655440001
                        status:
                          type: string
                          example: TRANSFERRED
                        type:
                          type: string
                          example: ONE_STEP_ONBOARDING
                        workflow:
                          type: string
                          example: DIRECT
                        provider:
                          type: object
                          properties:
                            id:
                              type: string
                              example: STRIPE
                            recipient_id:
                              type: string
                              example: acct_1234567890
                            connection_id:
                              type: string
                              example: 880e8400-e29b-41d4-a716-446655440003
                        recipient:
                          type: object
                          properties:
                            id:
                              type: string
                              example: 770e8400-e29b-41d4-a716-446655440002
                            merchant_recipient_id:
                              type: string
                              example: seller-123
                            email:
                              type: string
                              example: seller@example.com
                        created_at:
                          type: string
                          example: '2026-01-15T10:00:00Z'
                        updated_at:
                          type: string
                          example: '2026-01-15T16:59:22Z'
                    destination_onboarding:
                      type: object
                      properties:
                        id:
                          type: string
                          example: 990e8400-e29b-41d4-a716-446655440004
                        status:
                          type: string
                          example: SUCCEEDED
                        type:
                          type: string
                          example: ONE_STEP_ONBOARDING
                        provider:
                          type: object
                          properties:
                            id:
                              type: string
                              example: STRIPE
                            recipient_id:
                              type: string
                              example: acct_0987654321
                            connection_id:
                              type: string
                              example: 880e8400-e29b-41d4-a716-446655440003
                        recipient:
                          type: object
                          properties:
                            id:
                              type: string
                              example: aa0e8400-e29b-41d4-a716-446655440005
                            merchant_recipient_id:
                              type: string
                              example: seller-456
                            email:
                              type: string
                              example: newseller@example.com
                        created_at:
                          type: string
                          example: '2026-01-15T16:59:22Z'
                        updated_at:
                          type: string
                          example: '2026-01-15T16:59:23Z'
                    created_at:
                      type: string
                      example: '2026-01-15T16:59:22.996009Z'
                    updated_at:
                      type: string
                      example: '2026-01-15T16:59:23.734739Z'
        '403':
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                'Forbidden: Onboarding belongs to different organization':
                  summary: 'Forbidden: Onboarding belongs to different organization'
                  value:
                    code: FORBIDDEN
                    messages:
                      - You do not have permission to access this resource.
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ONBOARDING_NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                      example: Onboarding not found.
              examples:
                'Not Found: Onboarding does not exist':
                  summary: 'Not Found: Onboarding does not exist'
                  value:
                    code: ONBOARDING_NOT_FOUND
                    messages:
                      - Onboarding not found.
          description: Not Found
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      name: private-secret-key
      x-default: <Your private-secret-key>

````