> ## 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 el estado de una transferencia de entidad (Banking Connectivity)

> Recupera el estado actual de una transferencia bancaria iniciada a través de una cuenta

Recupera el estado actual y los detalles de una transferencia. Consulta [Transfer statuses](https://docs.y.uno/es/reference/banking-connectivity.md#transfer-statuses) para el ciclo de vida completo de los estados.


## OpenAPI

````yaml openapi/es/banking-connectivity/entity-transfers-banking-connectivity/get-entity-transfer-status.json GET /banking/transfers/{transfer_id}
openapi: 3.0.0
info:
  version: 1.0.0
  title: Banking Connectivity
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - public-api-key: []
    private-secret-key: []
paths:
  /banking/transfers/{transfer_id}:
    get:
      tags:
        - Entity Transfers (Banking Connectivity)
      summary: Get Entity Transfer Status (Banking Connectivity)
      operationId: get_v1-banking-transfers-transfer-id
      parameters:
        - in: path
          name: transfer_id
          schema:
            type: string
          required: true
          description: >-
            El `id` de la transferencia obtenido de [Initiate Entity
            Transfer](/es/reference/banking-connectivity/entity-transfers-banking-connectivity/initiate-entity-transfer)
            (UUID, 36 caracteres).
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                Pending:
                  summary: Pending
                  value:
                    id: bb0e8400-e29b-41d4-a716-446655440000
                    source_account_id: aa0e8400-e29b-41d4-a716-446655440000
                    destination_account_id: null
                    account_id: 550e8400-e29b-41d4-a716-446655440000
                    merchant_transfer_id: merchant_txn_12345
                    provider:
                      account_id: col_bank_account_789
                      transfer_id: col_transfer_xyz123
                    status: PENDING
                    transfer_type: OUTGOING
                    destination_account:
                      account_number_last_4: '3210'
                      routing_number: '987654321'
                      iban: null
                      bsb: null
                      swift: null
                      sort_code: null
                      account_name: Jane Smith
                      bank_name: Chase Bank
                    amount:
                      value: 1000
                      currency: USD
                    payment_rail: ACH_STANDARD
                    description: Payment to vendor
                    created_at: '2026-02-01T10:15:00Z'
                    updated_at: '2026-02-01T10:15:00Z'
                Completed:
                  summary: Completed
                  value:
                    id: bb0e8400-e29b-41d4-a716-446655440000
                    source_account_id: aa0e8400-e29b-41d4-a716-446655440000
                    destination_account_id: null
                    account_id: 550e8400-e29b-41d4-a716-446655440000
                    merchant_transfer_id: merchant_txn_12345
                    provider:
                      account_id: col_bank_account_789
                      transfer_id: col_transfer_xyz123
                    status: COMPLETED
                    transfer_type: OUTGOING
                    destination_account:
                      account_number_last_4: '3210'
                      routing_number: '987654321'
                      iban: null
                      bsb: null
                      swift: null
                      sort_code: null
                      account_name: Jane Smith
                      bank_name: Chase Bank
                    amount:
                      value: 1000
                      currency: USD
                    payment_rail: ACH_STANDARD
                    description: Payment to vendor
                    created_at: '2026-02-01T10:15:00Z'
                    updated_at: '2026-02-02T14:30:00Z'
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: NOT_AUTHENTICATED
                  messages:
                    type: array
                    items:
                      type: string
                      example: Missing required authentication headers
              examples:
                Unauthorized:
                  summary: Unauthorized
                  value:
                    code: NOT_AUTHENTICATED
                    messages:
                      - Missing required authentication headers
          description: No autorizado
        '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:
                  summary: Not Found
                  value:
                    code: TRANSFER_NOT_FOUND
                    messages:
                      - Transfer not found.
          description: No encontrado
components:
  securitySchemes:
    public-api-key:
      type: apiKey
      in: header
      name: public-api-key
    private-secret-key:
      type: apiKey
      in: header
      name: private-secret-key

````

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