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

# Crear onboarding de entidad (Banking Connectivity)

> Realiza el onboarding de una entidad existente con un proveedor de banking connectivity mediante documentación KYC o KYB

Realiza el onboarding de una [entidad](https://docs.y.uno/es/reference/banking-connectivity/entities-banking-connectivity/create-entity.md) existente con un proveedor de Banking Connectivity.

## Tipos de onboarding

* **`ONE_STEP`**: Envía de una sola vez toda la información, las declaraciones de cumplimiento, la evaluación de riesgo y los documentos. El proveedor lo procesa de inmediato.
* **`PREVIOUSLY_ONBOARDED`**: Genera un ID de onboarding interno de Yuno sin contactar al proveedor. Úsalo cuando la entidad ya pasó por el onboarding de forma externa.

Para `ONE_STEP`, incluye `compliance_declaration`, `risk_assessment`, `source_of_funds` y `documentation`. Consulta [Tipos de documentación](https://docs.y.uno/es/reference/banking-connectivity.md#documentation-types) para ver la lista completa de tipos de documento admitidos.

Monitorea el progreso mediante [Obtener el estado del onboarding de una entidad](https://docs.y.uno/es/reference/banking-connectivity/entity-onboarding-banking-connectivity/get-entity-onboarding-status.md) o eventos de webhook. Consulta [Estados del 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/create-entity-onboarding.json POST /banking/entities/{entity_id}/onboardings
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:
    post:
      tags:
        - Entity Onboarding (Banking Connectivity)
      summary: Create Entity Onboarding (Banking Connectivity)
      operationId: post_v1-banking-connectivity-entities-entity-id-onboardings
      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: header
          name: x-idempotency-key
          schema:
            type: string
          description: >-
            Identificador único que se usa en los encabezados HTTP para asegurar
            que una solicitud se procese una sola vez, aunque se reintente por
            problemas de red o tiempos de espera agotados. Consulta
            [autenticación](/es/reference/getting-started/authentication#idempotency)
            para ver los detalles (UUID).
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - account_id
                - onboarding_type
              properties:
                account_id:
                  type: string
                  description: >-
                    El identificador único de la cuenta de Yuno del comercio
                    (UUID, 36 caracteres).
                  example: 550e8400-e29b-41d4-a716-446655440000
                connection_id:
                  type: string
                  description: >-
                    El identificador de la conexión con el proveedor de Banking
                    Connectivity (UUID, 36 caracteres).
                  example: bb0e8400-e29b-41d4-a716-446655440001
                onboarding_type:
                  type: string
                  description: >-
                    El tipo de flujo de onboarding. `ONE_STEP` envía toda la
                    información de una vez para que la procese el proveedor.
                    `PREVIOUSLY_ONBOARDED` genera un ID interno de Yuno sin
                    contactar al proveedor.
                  enum:
                    - ONE_STEP
                    - PREVIOUSLY_ONBOARDED
                  example: ONE_STEP
                compliance_declaration:
                  type: object
                  description: >-
                    Acuerdos legales aceptados por la entidad. Obligatorio para
                    el onboarding `ONE_STEP`.
                  properties:
                    terms_of_service:
                      type: object
                      description: Registro de aceptación de los términos de servicio.
                      required:
                        - accepted
                        - accepted_at
                      properties:
                        accepted:
                          type: boolean
                          description: Indica si se aceptaron los términos de servicio.
                          example: true
                        version:
                          type: string
                          description: La versión de los términos aceptados.
                          example: 1.2.0
                        accepted_at:
                          type: string
                          description: >-
                            La marca de tiempo del momento de la aceptación (ISO
                            8601).
                          example: '2026-02-01T10:00:00Z'
                        accepted_ip:
                          type: string
                          description: >-
                            La dirección IP desde la que se aceptaron los
                            términos.
                          example: 192.168.1.1
                    privacy_policy:
                      type: object
                      description: Registro de aceptación de la política de privacidad.
                      required:
                        - accepted
                        - accepted_at
                      properties:
                        accepted:
                          type: boolean
                          description: Indica si se aceptó la política de privacidad.
                          example: true
                        version:
                          type: string
                          description: La versión de la política de privacidad aceptada.
                          example: 2.1.0
                        accepted_at:
                          type: string
                          description: >-
                            La marca de tiempo del momento de la aceptación (ISO
                            8601).
                          example: '2026-02-01T10:00:00Z'
                        accepted_ip:
                          type: string
                          description: La dirección IP desde la que se aceptó la política.
                          example: 192.168.1.1
                    ip_address:
                      type: string
                      description: >-
                        Dirección IP desde la que se aceptó la declaración de
                        cumplimiento.
                      example: 192.168.1.1
                    accepted_at:
                      type: string
                      format: date-time
                      description: >-
                        Fecha y hora en que se aceptó la declaración de
                        cumplimiento (ISO 8601).
                      example: '2026-02-01T10:00:00Z'
                  required:
                    - ip_address
                    - accepted_at
                risk_assessment:
                  type: object
                  description: >-
                    Resultados de verificación de cumplimiento preexistentes que
                    aporta el comercio.
                  properties:
                    assessed_at:
                      type: string
                      description: >-
                        La marca de tiempo del momento en que se realizó la
                        evaluación (ISO 8601).
                      example: '2026-02-01T10:00:00Z'
                    pep_status:
                      type: object
                      description: >-
                        Resultados de la verificación de personas expuestas
                        políticamente (PEP).
                      properties:
                        is_pep:
                          type: boolean
                          description: Indica si la entidad es una PEP.
                          example: false
                        pep_level:
                          type: string
                          nullable: true
                          description: El nivel de clasificación de la PEP.
                          enum:
                            - DIRECT
                            - CLOSE_ASSOCIATE
                            - FAMILY_MEMBER
                            - null
                          example: null
                        position:
                          type: string
                          nullable: true
                          description: El rol o cargo político, si corresponde.
                          example: null
                        country:
                          type: string
                          nullable: true
                          description: El país de la condición de PEP.
                          example: null
                    rca_status:
                      type: object
                      description: Resultados de la evaluación de clasificación de riesgo.
                      properties:
                        risk_level:
                          type: string
                          description: El nivel de riesgo evaluado.
                          enum:
                            - LOW
                            - MEDIUM
                            - HIGH
                          example: LOW
                        classified_at:
                          type: string
                          description: >-
                            La marca de tiempo del momento de la clasificación
                            (ISO 8601).
                          example: '2026-02-01T10:00:00Z'
                        assessed_by:
                          type: string
                          description: El nombre del evaluador o equipo.
                          example: Merchant Compliance Team
                    sanctions_screening:
                      type: object
                      description: Resultados de la verificación en listas de sanciones.
                      properties:
                        appears_on_sanctions_list:
                          type: boolean
                          description: >-
                            Indica si la entidad aparece en alguna lista de
                            sanciones.
                          example: false
                        sanctions_list_name:
                          type: string
                          nullable: true
                          description: >-
                            El nombre de la lista de sanciones, si hubo
                            coincidencia.
                          example: null
                        screened_at:
                          type: string
                          description: >-
                            La marca de tiempo del momento en que se realizó la
                            verificación (ISO 8601).
                          example: '2026-02-01T09:00:00Z'
                source_of_funds:
                  type: object
                  description: Información AML/KYC sobre el origen de los fondos.
                  properties:
                    primary_source:
                      type: string
                      description: El origen principal de los fondos.
                      enum:
                        - EMPLOYMENT_SALARY
                        - BUSINESS_INCOME
                        - INVESTMENTS
                        - RENTAL_INCOME
                        - PENSION
                        - GOVERNMENT_BENEFITS
                        - INHERITANCE
                        - FAMILY_SUPPORT
                        - SAVINGS
                        - LOTTERY_GAMBLING
                        - SALE_OF_ASSETS
                        - CRYPTOCURRENCY
                        - FREELANCE_CONSULTING
                        - OTHER
                      example: EMPLOYMENT_SALARY
                    secondary_sources:
                      type: array
                      description: Orígenes adicionales de los fondos.
                      items:
                        type: string
                      example:
                        - INVESTMENTS
                    description:
                      type: string
                      description: Una explicación detallada del origen de los fondos.
                      example: >-
                        Primary income from full-time employment as software
                        engineer, supplemented by stock portfolio dividends
                    estimated_annual_income:
                      type: object
                      description: El ingreso anual estimado.
                      properties:
                        amount:
                          type: number
                          description: El monto del ingreso anual.
                          example: 175000
                        currency:
                          type: string
                          description: >-
                            La moneda ([ISO
                            4217](https://en.wikipedia.org/wiki/ISO_4217)).
                          example: USD
                    primary:
                      type: string
                      description: El origen principal de los fondos. Lo exige la API.
                      enum:
                        - EMPLOYMENT_SALARY
                        - BUSINESS_INCOME
                        - INVESTMENTS
                        - RENTAL_INCOME
                        - PENSION
                        - GOVERNMENT_BENEFITS
                        - INHERITANCE
                        - FAMILY_SUPPORT
                        - SAVINGS
                        - LOTTERY_GAMBLING
                        - SALE_OF_ASSETS
                        - CRYPTOCURRENCY
                        - FREELANCE_CONSULTING
                        - OTHER
                      example: EMPLOYMENT_SALARY
                  required:
                    - primary
                documentation:
                  type: array
                  description: >-
                    Documentos KYC/KYB. Cada elemento tiene un `document_type` y
                    un subobjeto con ese nombre (`identity_document`,
                    `proof_of_address`, `bank_statement`, `tax_information`,
                    `biometric_verification`, `employment_information`,
                    `business_document`, `financial_document`). Las fechas usan
                    `YYYY-MM-DD`. Los archivos deben ser `image/jpeg`,
                    `image/png`, `application/pdf` o `image/tiff`.
                  items:
                    type: object
                    required:
                      - document_type
                    properties:
                      document_type:
                        type: string
                        description: >-
                          El tipo de documento. Selecciona el subobjeto que
                          debes enviar con el mismo nombre en minúsculas, por
                          ejemplo `BANK_STATEMENT` requiere `bank_statement`.
                        example: BANK_STATEMENT
                        enum:
                          - IDENTITY_DOCUMENT
                          - PROOF_OF_ADDRESS
                          - BANK_STATEMENT
                          - TAX_INFORMATION
                          - BIOMETRIC_VERIFICATION
                          - EMPLOYMENT_INFORMATION
                          - BUSINESS_DOCUMENT
                          - FINANCIAL_DOCUMENT
                      identity_document:
                        type: object
                        required:
                          - document_number
                          - issuing_country
                          - files
                        properties:
                          document_number:
                            type: string
                            description: El número del documento.
                            example: D1234567
                          document_subtype:
                            type: string
                            description: El subtipo del documento.
                            example: DRIVERS_LICENSE
                          issuing_country:
                            type: string
                            description: El país emisor (ISO 3166-1 alpha-2).
                            example: US
                          expires_at:
                            type: string
                            description: La fecha de vencimiento. Formato `YYYY-MM-DD`.
                            example: '2028-01-15'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      proof_of_address:
                        type: object
                        required:
                          - issuing_country
                          - files
                        properties:
                          issuing_country:
                            type: string
                            description: El país emisor (ISO 3166-1 alpha-2).
                            example: US
                          issued_at:
                            type: string
                            description: La fecha de emisión. Formato `YYYY-MM-DD`.
                            example: '2026-01-01'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      bank_statement:
                        type: object
                        required:
                          - files
                        properties:
                          bank_name:
                            type: string
                            description: El nombre del banco.
                            example: Chase Bank
                          account_number_last_4:
                            type: string
                            description: >-
                              Los últimos 4 caracteres del número de cuenta.
                              Deben ser exactamente 4 caracteres.
                            example: '1234'
                          period_start_at:
                            type: string
                            description: >-
                              El inicio del período del extracto. Formato
                              `YYYY-MM-DD`.
                            example: '2025-12-01'
                          period_end_at:
                            type: string
                            description: >-
                              El fin del período del extracto. Formato
                              `YYYY-MM-DD`.
                            example: '2025-12-31'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      tax_information:
                        type: object
                        required:
                          - tax_records
                        properties:
                          tax_records:
                            type: array
                            minItems: 1
                            items:
                              type: object
                              required:
                                - tax_number_type
                                - tax_number
                                - country
                              properties:
                                tax_number_type:
                                  type: string
                                  description: El tipo de número fiscal.
                                  example: SSN
                                  enum:
                                    - SSN
                                    - EIN
                                    - ITIN
                                    - ABN
                                    - NINO
                                    - NIF
                                    - OTHER
                                tax_number:
                                  type: string
                                  description: El número fiscal.
                                  example: 123-45-6789
                                country:
                                  type: string
                                  description: El país (ISO 3166-1 alpha-2).
                                  example: US
                                is_primary:
                                  type: boolean
                                  example: true
                      biometric_verification:
                        type: object
                        required:
                          - verification_type
                          - files
                        properties:
                          verification_type:
                            type: string
                            description: El tipo de verificación.
                            example: FACE_MATCH
                          confidence_score:
                            type: number
                            minimum: 0
                            maximum: 1
                            description: Un número decimal entre 0.0 y 1.0.
                            example: 0.98
                          verified_at:
                            type: string
                            description: La fecha de verificación. Formato `YYYY-MM-DD`.
                            example: '2026-01-20'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      employment_information:
                        type: object
                        required:
                          - files
                        properties:
                          employer_name:
                            type: string
                            description: El nombre del empleador.
                            example: Acme Corp
                          job_title:
                            type: string
                            description: El cargo.
                            example: Software Engineer
                          started_at:
                            type: string
                            description: La fecha de inicio. Formato `YYYY-MM-DD`.
                            example: '2020-03-01'
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      business_document:
                        type: object
                        required:
                          - subtype
                          - files
                        properties:
                          subtype:
                            type: string
                            description: El subtipo de documento comercial.
                            example: ARTICLES_OF_INCORPORATION
                            enum:
                              - ARTICLES_OF_INCORPORATION
                              - BUSINESS_LICENSE
                              - EIN_CONFIRMATION
                              - OPERATING_AGREEMENT
                              - CERTIFICATE_OF_GOOD_STANDING
                          registration_number:
                            type: string
                            description: El número de registro.
                            example: REG-123456
                          registered_at:
                            type: string
                            description: La fecha de registro. Formato `YYYY-MM-DD`.
                            example: '2018-05-10'
                          issuing_state:
                            type: string
                            description: El estado emisor.
                            example: DE
                          issuing_authority:
                            type: string
                            description: La autoridad emisora.
                            example: Delaware Secretary of State
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
                      financial_document:
                        type: object
                        required:
                          - subtype
                          - files
                        properties:
                          subtype:
                            type: string
                            description: El subtipo de documento financiero.
                            example: BALANCE_SHEET
                            enum:
                              - BALANCE_SHEET
                              - PROFIT_LOSS_STATEMENT
                              - CASH_FLOW_STATEMENT
                              - FINANCIAL_AUDIT
                          period_start_at:
                            type: string
                            description: El inicio del período. Formato `YYYY-MM-DD`.
                            example: '2025-01-01'
                          period_end_at:
                            type: string
                            description: El fin del período. Formato `YYYY-MM-DD`.
                            example: '2025-12-31'
                          fiscal_year:
                            type: integer
                            example: 2025
                          audited:
                            type: boolean
                            example: true
                          auditor_name:
                            type: string
                            description: El nombre del auditor.
                            example: Example Audit LLP
                          files:
                            type: array
                            minItems: 1
                            description: >-
                              Los archivos que respaldan el documento. Se
                              requiere al menos un archivo.
                            items:
                              type: object
                              required:
                                - file_name
                                - content_type
                                - content
                              properties:
                                file_name:
                                  type: string
                                  description: El nombre del archivo.
                                  example: document.pdf
                                content_type:
                                  type: string
                                  description: El tipo de medio del archivo.
                                  example: application/pdf
                                  enum:
                                    - image/jpeg
                                    - image/png
                                    - application/pdf
                                    - image/tiff
                                content:
                                  type: string
                                  description: >-
                                    El contenido del archivo, codificado en
                                    base64.
                                  example: base64_encoded_content
            examples:
              Create entity onboarding:
                summary: Create entity onboarding
                value:
                  account_id: 550e8400-e29b-41d4-a716-446655440000
                  connection_id: bb0e8400-e29b-41d4-a716-446655440001
                  onboarding_type: ONE_STEP
                  compliance_declaration:
                    terms_of_service:
                      accepted: true
                      version: 1.2.0
                      accepted_at: '2026-02-01T10:00:00Z'
                      accepted_ip: 192.168.1.1
                    privacy_policy:
                      accepted: true
                      version: 2.1.0
                      accepted_at: '2026-02-01T10:00:00Z'
                      accepted_ip: 192.168.1.1
                    ip_address: 192.168.1.1
                    accepted_at: '2026-02-01T10:00:00Z'
                  risk_assessment:
                    assessed_at: '2026-02-01T10:00:00Z'
                    pep_status:
                      is_pep: false
                      pep_level: null
                      position: null
                      country: null
                    rca_status:
                      risk_level: LOW
                      classified_at: '2026-02-01T10:00:00Z'
                      assessed_by: Merchant Compliance Team
                    sanctions_screening:
                      appears_on_sanctions_list: false
                      sanctions_list_name: null
                      screened_at: '2026-02-01T09:00:00Z'
                  source_of_funds:
                    primary_source: EMPLOYMENT_SALARY
                    secondary_sources:
                      - INVESTMENTS
                    description: >-
                      Primary income from full-time employment as software
                      engineer, supplemented by stock portfolio dividends
                    estimated_annual_income:
                      amount: 175000
                      currency: USD
                    primary: EMPLOYMENT_SALARY
                  documentation:
                    - document_type: IDENTITY_DOCUMENT
                      identity_document:
                        document_number: D1234567
                        document_subtype: DRIVERS_LICENSE
                        issuing_country: US
                        expires_at: '2028-01-15'
                        files:
                          - file_name: license_front.jpg
                            content_type: image/jpeg
                            content: base64_encoded_content
                          - file_name: license_back.jpg
                            content_type: image/jpeg
                            content: base64_encoded_content
                    - document_type: BANK_STATEMENT
                      bank_statement:
                        bank_name: Chase Bank
                        account_number_last_4: '1234'
                        period_start_at: '2025-12-01'
                        period_end_at: '2025-12-31'
                        files:
                          - file_name: bank_statement_dec_2025.pdf
                            content_type: application/pdf
                            content: base64_encoded_content
              Previously onboarded:
                summary: Previously onboarded
                value:
                  account_id: 550e8400-e29b-41d4-a716-446655440000
                  connection_id: bb0e8400-e29b-41d4-a716-446655440001
                  onboarding_type: PREVIOUSLY_ONBOARDED
      responses:
        '200':
          description: ''
        '201':
          content:
            application/json:
              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.
              examples:
                Created (Entity onboarding):
                  summary: Created (Entity onboarding)
                  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'
          description: Creado
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: VALIDATION_ERROR
                  messages:
                    type: array
                    items:
                      type: string
                      example: >-
                        compliance_declaration is required for ONE_STEP
                        onboarding
              examples:
                Bad Request:
                  summary: Bad Request
                  value:
                    code: VALIDATION_ERROR
                    messages:
                      - >-
                        compliance_declaration is required for ONE_STEP
                        onboarding
          description: Solicitud incorrecta
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: ENTITY_NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                      example: Entity not found
              examples:
                Not Found:
                  summary: Not Found
                  value:
                    code: ENTITY_NOT_FOUND
                    messages:
                      - Entity 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.