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

> Obtén los detalles de una entidad existente, ya sea individual o empresarial

Obtén los detalles de una entidad existente. Los campos sensibles aparecen enmascarados en la respuesta.


## OpenAPI

````yaml openapi/es/banking-connectivity/entities-banking-connectivity/get-entity-details.json GET /banking/entities/{entity_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}:
    get:
      tags:
        - Entities (Banking Connectivity)
      summary: Obtener detalles de la entidad (Banking Connectivity)
      operationId: get_v1-banking-connectivity-entities-entity-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)
      responses:
        '200':
          description: ''
          content:
            application/json:
              examples:
                OK:
                  summary: OK
                  value:
                    account_id: 550e8400-e29b-41d4-a716-446655440000
                    merchant_entity_id: merchant_user_12345
                    phone:
                      country_code: '+1'
                      number: '2025551234'
                    address:
                      address_line_1: 123 Main St
                      address_line_2: Apt 4B
                      building_number: '123'
                      city: San Francisco
                      state: CA
                      zip_code: '94102'
                      country: US
                    entity_detail:
                      individual:
                        first_name: John
                        last_name: Doe
                        email: john@example.com
                        date_of_birth: '1990-01-15'
                        gender: M
                        country_of_residence: US
                        tax_information:
                          - country: US
                            tax_id_last4: '*******6789'
                            tax_id_type: SSN
                            is_primary: true
                        document:
                          document_type: SSN
                          document_number_last4: '*******6789'
                          issuing_country: US
                          issuing_date: '2010-01-15'
                          expiry_date: '2030-01-15'
                      entity: null
                    id: d9266469-850a-4ccf-868b-af832c2f081d
                    entity_type: INDIVIDUAL
                    created_at: '2026-10-23T08:50:39.887085Z'
                    updated_at: '2026-10-23T08:50:39.88711Z'
              schema:
                type: object
                properties:
                  account_id:
                    type: string
                    example: 550e8400-e29b-41d4-a716-446655440000
                  merchant_entity_id:
                    type: string
                    example: merchant_user_12345
                  phone:
                    type: object
                    properties:
                      country_code:
                        type: string
                        example: '+1'
                      number:
                        type: string
                        example: '2025551234'
                  address:
                    type: object
                    properties:
                      address_line_1:
                        type: string
                        example: 123 Main St
                      address_line_2:
                        type: string
                        example: Apt 4B
                      building_number:
                        type: string
                        example: '123'
                      city:
                        type: string
                        example: San Francisco
                      state:
                        type: string
                        example: CA
                      zip_code:
                        type: string
                        example: '94102'
                      country:
                        type: string
                        example: US
                  entity_detail:
                    type: object
                    properties:
                      individual:
                        type: object
                        properties:
                          first_name:
                            type: string
                            example: John
                          last_name:
                            type: string
                            example: Doe
                          email:
                            type: string
                            example: john@example.com
                          date_of_birth:
                            type: string
                            example: '1990-01-15'
                          gender:
                            type: string
                            example: M
                          country_of_residence:
                            type: string
                            example: US
                          tax_information:
                            type: array
                            items:
                              type: object
                              properties:
                                country:
                                  type: string
                                  example: US
                                tax_id_last4:
                                  type: string
                                  example: '*******6789'
                                tax_id_type:
                                  type: string
                                  example: SSN
                                is_primary:
                                  type: boolean
                                  example: true
                                  default: true
                          document:
                            type: object
                            properties:
                              document_type:
                                type: string
                                example: SSN
                              document_number_last4:
                                type: string
                                example: '*******6789'
                              issuing_country:
                                type: string
                                example: US
                              issuing_date:
                                type: string
                                example: '2010-01-15'
                              expiry_date:
                                type: string
                                example: '2030-01-15'
                      entity: {}
                  id:
                    type: string
                    example: d9266469-850a-4ccf-868b-af832c2f081d
                    description: Id.
                  entity_type:
                    type: string
                    example: INDIVIDUAL
                    description: Tipo de entidad.
                  created_at:
                    type: string
                    example: '2026-10-23T08:50:39.887085Z'
                    description: Fecha de creación.
                  updated_at:
                    type: string
                    example: '2026-10-23T08:50:39.88711Z'
                    description: Fecha de actualización.
        '400':
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                Entity Not Found:
                  summary: Entity Not Found
                  value:
                    code: ENTITY_NOT_FOUND
                    messages:
                      - Entity not found.
          description: Solicitud incorrecta. La entidad no existe para esta cuenta.
        '401':
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                Unauthorized:
                  summary: Unauthorized
                  value:
                    code: NOT_AUTHENTICATED
                    messages:
                      - Missing required authentication headers
                    http_code: 401
          description: No autorizado
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.