> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.arb.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# Get email addresses for user IDs

> Retrieves email addresses for multiple user IDs in a single request. Returns null for users that do not exist. Requires `auth.email.viewer` permission.



## OpenAPI

````yaml api-reference/auth.yaml post /internal/user-emails
openapi: 3.0.3
info:
  title: auth
  description: >-
    The Auth Service is the single source of truth for all accounts and their
    permissions, managing authentication and access control across the platform.
    It maintains efficiency at scale by issuing access tokens to accounts when
    they log into the platform and providing public keys for other services to
    verify them.
  version: 1.0.0
servers:
  - url: https://auth.platform.arb.inc
security: []
tags:
  - name: /
  - name: authenticate
  - name: internal
  - name: organizations
  - name: sessions
  - name: users
paths:
  /internal/user-emails:
    post:
      tags:
        - internal
      summary: Get email addresses for user IDs
      description: >-
        Retrieves email addresses for multiple user IDs in a single request.
        Returns null for users that do not exist. Requires `auth.email.viewer`
        permission.
      operationId: getUserEmails
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - users
              properties:
                users:
                  type: array
                  description: Array of user IDs to retrieve emails for
                  items:
                    type: string
                    format: uuid
                  example:
                    - 8f3a4b2c-1d5e-4f6a-9b7c-3e2d1a0b9c8d
                    - 5c2d1e4f-6a7b-8c9d-0e1f-2a3b4c5d6e7f
      responses:
        '200':
          description: Successfully retrieved email addresses
          content:
            application/json:
              schema:
                type: object
                properties:
                  users:
                    type: object
                    description: >-
                      Map of user IDs to email addresses (null if user does not
                      exist)
                    additionalProperties:
                      type: string
                      nullable: true
                      format: email
                    example:
                      8f3a4b2c-1d5e-4f6a-9b7c-3e2d1a0b9c8d: user@example.com
                      5c2d1e4f-6a7b-8c9d-0e1f-2a3b4c5d6e7f: null
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````