> ## 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.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Obtener una transferencia por ID

> Obtén los detalles y el estado de una transferencia específica a partir de su identificador

Obtén una sola transferencia usando su `transfer_id`.

## Campos de la respuesta

| Campo | Tipo | Descripción |
| - | - | - |
| `id` | UUID | Identificador único de la transferencia |
| `origin_onboarding` | object | Onboarding completo que se transfirió (incluye los detalles del destinatario) |
| `destination_onboarding` | object | Onboarding completo que recibió la transferencia (incluye los detalles del destinatario) |
| `created_at` | timestamp | Cuándo se creó la transferencia |
| `updated_at` | timestamp | Cuándo se actualizó la transferencia por última vez |

## Cómo inferir el estado de la transferencia

Revisa `destination_onboarding.status`:

`SUCCEEDED`: La transferencia se completó correctamente
`PENDING`: La transferencia está en curso
`FAILED`: La transferencia falló
`TRANSFERRED`: El onboarding de origen se transfirió


## OpenAPI

````yaml openapi/es/recipients-for-marketplace/get-transfers/get-transfer-by-id.json GET /transfers/{transfer_id}
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
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /transfers/{transfer_id}:
    get:
      operationId: get_transfers-transfer-id
      parameters:
        - in: path
          name: transfer_id
          schema:
            type: string
          required: true
          description: >-
            El `id` de la transferencia devuelto por el endpoint de [transferir
            onboarding](/es/reference/recipients-for-marketplace/transfer-onboarding)
            (UUID).
        - in: header
          name: x-account-code
          schema:
            type: string
          description: >-
            El `account_id` que encuentras en tu [Dashboard de
            Yuno](https://dashboard.y.uno/developers) (UUID).
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                OK:
                  summary: OK
                  value:
                    id: 550e8400-e29b-41d4-a716-446655440000
                    origin_onboarding:
                      id: 660e8400-e29b-41d4-a716-446655440001
                      status: TRANSFERRED
                      type: ONE_STEP_ONBOARDING
                      workflow: DIRECT
                      response_message: null
                      provider:
                        id: STRIPE
                        recipient_id: acct_1234567890
                        connection_id: 880e8400-e29b-41d4-a716-446655440003
                        legal_entity: COMPANY
                      documentation: []
                      legal_representatives: []
                      requirements: []
                      metadata: []
                      withdrawal_methods: null
                      capabilities: null
                      recipient:
                        id: 770e8400-e29b-41d4-a716-446655440002
                        merchant_recipient_id: seller-123
                        country: BR
                        national_entity: INDIVIDUAL
                        entity_type: PERSON
                        email: seller@example.com
                        first_name: João
                        last_name: Silva
                        created_at: '2026-01-10T12:00:00Z'
                        updated_at: '2026-01-10T12:00:00Z'
                      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
                      workflow: DIRECT
                      response_message: null
                      provider:
                        id: STRIPE
                        recipient_id: acct_0987654321
                        connection_id: 880e8400-e29b-41d4-a716-446655440003
                        legal_entity: COMPANY
                      documentation: []
                      legal_representatives: []
                      requirements: []
                      metadata: []
                      withdrawal_methods: null
                      capabilities: null
                      recipient:
                        id: aa0e8400-e29b-41d4-a716-446655440005
                        merchant_recipient_id: seller-456
                        country: BR
                        national_entity: INDIVIDUAL
                        entity_type: PERSON
                        email: newseller@example.com
                        first_name: Maria
                        last_name: Santos
                        created_at: '2026-01-12T14:00:00Z'
                        updated_at: '2026-01-12T14:00:00Z'
                      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: 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
                      response_message: {}
                      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
                          legal_entity:
                            type: string
                            example: COMPANY
                      documentation:
                        type: array
                        items:
                          type: object
                          properties: {}
                      legal_representatives:
                        type: array
                        items:
                          type: object
                          properties: {}
                      requirements:
                        type: array
                        items:
                          type: object
                          properties: {}
                      metadata:
                        type: array
                        items:
                          type: object
                          properties: {}
                      withdrawal_methods: {}
                      capabilities: {}
                      recipient:
                        type: object
                        properties:
                          id:
                            type: string
                            example: 770e8400-e29b-41d4-a716-446655440002
                          merchant_recipient_id:
                            type: string
                            example: seller-123
                          country:
                            type: string
                            example: BR
                          national_entity:
                            type: string
                            example: INDIVIDUAL
                          entity_type:
                            type: string
                            example: PERSON
                          email:
                            type: string
                            example: seller@example.com
                          first_name:
                            type: string
                            example: João
                          last_name:
                            type: string
                            example: Silva
                          created_at:
                            type: string
                            example: '2026-01-10T12:00:00Z'
                          updated_at:
                            type: string
                            example: '2026-01-10T12:00:00Z'
                      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
                      workflow:
                        type: string
                        example: DIRECT
                      response_message: {}
                      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
                          legal_entity:
                            type: string
                            example: COMPANY
                      documentation:
                        type: array
                        items:
                          type: object
                          properties: {}
                      legal_representatives:
                        type: array
                        items:
                          type: object
                          properties: {}
                      requirements:
                        type: array
                        items:
                          type: object
                          properties: {}
                      metadata:
                        type: array
                        items:
                          type: object
                          properties: {}
                      withdrawal_methods: {}
                      capabilities: {}
                      recipient:
                        type: object
                        properties:
                          id:
                            type: string
                            example: aa0e8400-e29b-41d4-a716-446655440005
                          merchant_recipient_id:
                            type: string
                            example: seller-456
                          country:
                            type: string
                            example: BR
                          national_entity:
                            type: string
                            example: INDIVIDUAL
                          entity_type:
                            type: string
                            example: PERSON
                          email:
                            type: string
                            example: newseller@example.com
                          first_name:
                            type: string
                            example: Maria
                          last_name:
                            type: string
                            example: Santos
                          created_at:
                            type: string
                            example: '2026-01-12T14:00:00Z'
                          updated_at:
                            type: string
                            example: '2026-01-12T14:00:00Z'
                      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'
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: UNAUTHORIZED
                  messages:
                    type: array
                    items:
                      type: string
                      example: Invalid authentication credentials.
              examples:
                'Unauthorized: Invalid authentication':
                  summary: 'Unauthorized: Invalid authentication'
                  value:
                    code: UNAUTHORIZED
                    messages:
                      - Invalid authentication credentials.
          description: No autorizado
        '403':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: FORBIDDEN
                  messages:
                    type: array
                    items:
                      type: string
                      example: You do not have permission to access this resource.
              examples:
                'Forbidden: Transfer belongs to different organization':
                  summary: 'Forbidden: Transfer belongs to different organization'
                  value:
                    code: FORBIDDEN
                    messages:
                      - You do not have permission to access this resource.
          description: Prohibido
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: TRANSFER_NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                      example: Transfer not found.
              examples:
                'Not Found: Transfer does not exist':
                  summary: 'Not Found: Transfer does not exist'
                  value:
                    code: TRANSFER_NOT_FOUND
                    messages:
                      - Transfer not found.
          description: No encontrado
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>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.