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

# Buscar usuarios por email

> Busca usuarios de la organización por dirección de email en lugar de un ID de usuario

Devuelve los usuarios de la organización autenticada cuya dirección de email coincide con el valor indicado. Usa este endpoint para obtener el registro de un usuario cuando tienes un email pero no el ID de usuario de Yuno.

> [!NOTE]
>
> **Alcance de la organización y resultados vacíos**
>
> Los resultados siempre se limitan a la organización que realiza la llamada. Si el mismo email existe en otra organización, no aparecerá aquí. Cuando ningún usuario de la organización coincide con la dirección, la respuesta contiene un arreglo `data` vacío en lugar de un error.


## OpenAPI

````yaml openapi/es/organizations/find-user-by-email.json GET /organizations/users
openapi: 3.1.0
info:
  title: Users API - Find by Email
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - sec0: []
    sec1: []
paths:
  /organizations/users:
    get:
      summary: Buscar usuarios por correo electrónico
      description: >-
        Devuelve los usuarios cuyo correo electrónico coincide con la dirección
        indicada, dentro del alcance de la organización autenticada. Una
        dirección de correo electrónico puede pertenecer a usuarios de varias
        organizaciones; solo se devuelven las coincidencias dentro de la
        organización que realiza la llamada. Cuando ningún usuario tiene ese
        correo electrónico, la respuesta contiene un arreglo `data` vacío: no es
        un error.
      operationId: find-user-by-email
      parameters:
        - name: email
          in: query
          required: true
          schema:
            type: string
            format: email
          description: >-
            Dirección de correo electrónico que se desea buscar. Debe ser una
            coincidencia exacta, sin distinguir mayúsculas de minúsculas.
      responses:
        '200':
          description: >-
            OK: cero o más usuarios que coinciden con la dirección de correo
            electrónico.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: >-
                      Lista de usuarios cuyo correo electrónico coincide con la
                      dirección solicitada dentro de la organización que realiza
                      la llamada. Está vacía cuando no hay coincidencias.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Identificador único del usuario generado por Yuno.
                        email:
                          type: string
                          description: Dirección de correo electrónico del usuario.
                        first_name:
                          type: string
                          description: Nombre del usuario.
                        last_name:
                          type: string
                          description: Apellido del usuario.
                        account_permissions:
                          type: array
                          description: >-
                            Lista de permisos a nivel de cuenta asignados a este
                            usuario.
                          items:
                            type: object
                            properties:
                              account_id:
                                type: string
                                format: uuid
                                description: Cuenta a la que se aplica el permiso.
                              role_id:
                                type: string
                                description: Rol asignado al usuario en esta cuenta.
                        account_group_permissions:
                          type: array
                          description: >-
                            Lista de permisos a nivel de grupo de cuentas
                            asignados a este usuario.
                          items:
                            type: object
                            properties:
                              account_group_id:
                                type: string
                                format: uuid
                                description: Grupo de cuentas al que se aplica el permiso.
                              role_id:
                                type: string
                                description: >-
                                  Rol asignado al usuario en este grupo de
                                  cuentas.
                        created_at:
                          type: string
                          format: date-time
                          description: Marca de tiempo ISO 8601 de la creación del usuario.
                        updated_at:
                          type: string
                          format: date-time
                          description: Marca de tiempo ISO 8601 de la última actualización.
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                      page_size:
                        type: integer
                      total_items:
                        type: integer
                      total_pages:
                        type: integer
                      has_next:
                        type: boolean
                      has_previous:
                        type: boolean
              examples:
                match_found:
                  summary: User found
                  value:
                    data:
                      - id: f1e2d3c4-b5a6-7890-fedc-ba0987654321
                        email: jane.doe@acme.com
                        first_name: Jane
                        last_name: Doe
                        account_permissions:
                          - account_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                            role_id: ADMIN
                        account_group_permissions: []
                        created_at: '2024-01-10T09:00:00Z'
                        updated_at: '2024-05-20T14:15:00Z'
                    pagination:
                      page: 1
                      page_size: 20
                      total_items: 1
                      total_pages: 1
                      has_next: false
                      has_previous: false
                no_match:
                  summary: No user matched — empty result
                  value:
                    data: []
                    pagination:
                      page: 1
                      page_size: 20
                      total_items: 0
                      total_pages: 0
                      has_next: false
                      has_previous: false
        '400':
          description: >-
            Solicitud incorrecta: el parámetro de consulta `email` falta o no es
            una dirección de correo electrónico válida.
        '401':
          description: 'No autorizado: las credenciales de la API no son válidas o faltan.'
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.