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

# Find Users by Email

> Look up organization users by email address instead of a user ID

Returns the user(s) within the authenticated organization whose email address matches the given value. Use this endpoint to resolve a user record when you have an email address but not the Yuno user ID.

<Note>
  **Organization scope and empty results**

  Results are always scoped to the calling organization. If the same email exists in another organization it will not appear here. When no user in the organization matches the address, the response contains an empty `data` array rather than an error.
</Note>


## OpenAPI

````yaml openapi/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
  - url: https://api.eu.y.uno/v1
security:
  - sec0: []
    sec1: []
paths:
  /organizations/users:
    get:
      summary: Find Users by Email
      description: >-
        Returns the user(s) whose email matches the given address, scoped to the
        authenticated organization. An email address may belong to users in
        multiple organizations; only matches within the calling organization are
        returned. When no user carries that email the response contains an empty
        `data` array — it is not an error.
      operationId: find-user-by-email
      parameters:
        - name: email
          in: query
          required: true
          schema:
            type: string
            format: email
          description: >-
            Email address to search for. Must be an exact, case-insensitive
            match.
      responses:
        '200':
          description: OK — zero or more users matching the email address.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    description: >-
                      List of users whose email matches the requested address
                      within the calling organization. Empty when no match is
                      found.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Yuno-generated unique identifier of the user.
                        email:
                          type: string
                          description: Email address of the user.
                        first_name:
                          type: string
                          description: User's first name.
                        last_name:
                          type: string
                          description: User's last name.
                        account_permissions:
                          type: array
                          description: >-
                            List of account-level permissions assigned to this
                            user.
                          items:
                            type: object
                            properties:
                              account_id:
                                type: string
                                format: uuid
                                description: Account the permission applies to.
                              role_id:
                                type: string
                                description: Role assigned to the user on this account.
                        account_group_permissions:
                          type: array
                          description: >-
                            List of account-group-level permissions assigned to
                            this user.
                          items:
                            type: object
                            properties:
                              account_group_id:
                                type: string
                                format: uuid
                                description: Account group the permission applies to.
                              role_id:
                                type: string
                                description: >-
                                  Role assigned to the user on this account
                                  group.
                        created_at:
                          type: string
                          format: date-time
                          description: ISO 8601 timestamp of when the user was created.
                        updated_at:
                          type: string
                          format: date-time
                          description: ISO 8601 timestamp of the last update.
                  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: >-
            Bad Request — `email` query parameter is missing or not a valid
            email address.
        '401':
          description: Unauthorized — invalid or missing API credentials.
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>

````