> ## 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 del onboarding de una entidad (Banking Connectivity)

> Recupera el estado actual del onboarding de una entidad con el proveedor

Recupera el estado actual del onboarding de una entidad. Consulta [Estados de onboarding](https://docs.y.uno/es/reference/banking-connectivity.md#onboarding-statuses) para ver el ciclo de vida completo de los estados.


## OpenAPI

````yaml openapi/es/banking-connectivity/entity-onboarding-banking-connectivity/get-entity-onboarding-status.json GET /banking/entities/{entity_id}/onboardings/{onboarding_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/entities/{entity_id}/onboardings/{onboarding_id}:
    get:
      tags:
        - Entity Onboarding (Banking Connectivity)
      summary: Get Entity Onboarding Status (Banking Connectivity)
      operationId: get_v1-banking-connectivity-entities-entity-id-onboardings-onboarding-id
      parameters:
        - in: path
          name: entity_id
          schema:
            type: string
          required: true
          description: >-
            El `id` de la entidad, que se obtiene de [Create
            Entity](/es/reference/banking-connectivity/entities-banking-connectivity/create-entity).
        - in: path
          name: onboarding_id
          schema:
            type: string
          required: true
          description: >-
            El `id` del onboarding obtenido de [Create Entity
            Onboarding](/es/reference/banking-connectivity/entity-onboarding-banking-connectivity/create-entity-onboarding).
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                Pending:
                  summary: Pending
                  value:
                    id: 990e8400-e29b-41d4-a716-446655440000
                    entity_id: 660e8400-e29b-41d4-a716-446655440000
                    account_id: 550e8400-e29b-41d4-a716-446655440000
                    provider:
                      name: example_bank
                      entity_id: col_entity_onboarded_123
                      status: verification_pending
                    onboarding_type: ONE_STEP
                    status: PENDING
                    requirements: []
                    created_at: '2026-02-01T10:00:00Z'
                    updated_at: '2026-02-01T10:00:00Z'
                    expires_at: '2026-02-08T10:00:00Z'
                Succeeded:
                  summary: Succeeded
                  value:
                    id: 990e8400-e29b-41d4-a716-446655440000
                    entity_id: 660e8400-e29b-41d4-a716-446655440000
                    account_id: 550e8400-e29b-41d4-a716-446655440000
                    provider:
                      name: example_bank
                      entity_id: col_entity_onboarded_123
                      status: active
                    onboarding_type: ONE_STEP
                    status: SUCCEEDED
                    requirements: []
                    created_at: '2026-02-01T10:00:00Z'
                    updated_at: '2026-02-03T14:30:00Z'
                    expires_at: '2026-02-08T10:00:00Z'
              schema:
                type: object
                properties:
                  id:
                    type: string
                    example: 990e8400-e29b-41d4-a716-446655440000
                  entity_id:
                    type: string
                    example: 660e8400-e29b-41d4-a716-446655440000
                  account_id:
                    type: string
                    example: 550e8400-e29b-41d4-a716-446655440000
                  provider:
                    type: object
                    properties:
                      name:
                        type: string
                        description: El nombre del proveedor.
                        example: example_bank
                      entity_id:
                        type: string
                        example: col_entity_onboarded_123
                      status:
                        type: string
                        example: verification_pending
                    description: >-
                      Los detalles del onboarding en el proveedor. Opcional: el
                      campo se omite cuando está vacío.
                  onboarding_type:
                    type: string
                    example: ONE_STEP
                  status:
                    type: string
                    example: PENDING
                  requirements:
                    type: array
                    items:
                      type: object
                      properties: {}
                    description: >-
                      Requisitos pendientes del onboarding. Opcional: el campo
                      se omite cuando está vacío.
                  created_at:
                    type: string
                    example: '2026-02-01T10:00:00Z'
                  updated_at:
                    type: string
                    example: '2026-02-01T10:00:00Z'
                  expires_at:
                    type: string
                    example: '2026-02-08T10:00:00Z'
                    description: >-
                      Cuándo vence el onboarding. Opcional: el campo se omite
                      cuando está vacío.
        '400':
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                Not Found:
                  summary: Not Found
                  value:
                    code: ONBOARDING_NOT_FOUND
                    messages:
                      - Onboarding not found.
          description: Solicitud incorrecta. El onboarding no existe para esta entidad.
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.