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

# Get End User Info

> Retrieve an end user by ID. Useful when other APIs return an end-user ID (e.g., `created_by` from [Upload File](/api-reference/files/upload-file)).



## OpenAPI

````yaml /en/api-reference/openapi_completion.json get /end-users/{end_user_id}
openapi: 3.0.1
info:
  title: Completion App API
  description: >-
    The text generation application offers non-session support and is ideal for
    translation, article writing, summarization AI, and more.
  version: 1.0.0
servers:
  - url: '{api_base_url}'
    description: >-
      The base URL for the Completion App API. Replace {api_base_url} with the
      actual API base URL provided for your application.
    variables:
      api_base_url:
        default: https://api.dify.ai/v1
        description: Actual base URL of the API
security:
  - ApiKeyAuth: []
tags:
  - name: Completions
    description: Operations related to text generation and completion.
  - name: Files
    description: Operations related to file management.
  - name: End Users
    description: Operations related to end user information.
  - name: Feedback
    description: Operations related to user feedback.
  - name: TTS
    description: Operations related to Text-to-Speech and Speech-to-Text.
  - name: Applications
    description: Operations to retrieve application settings and information.
paths:
  /end-users/{end_user_id}:
    get:
      tags:
        - End Users
      summary: Get End User Info
      description: >-
        Retrieve an end user by ID. Useful when other APIs return an end-user ID
        (e.g., `created_by` from [Upload
        File](/api-reference/files/upload-file)).
      operationId: getEndUserCompletion
      parameters:
        - name: end_user_id
          in: path
          required: true
          description: End user ID.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: End user retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EndUserDetail'
              examples:
                endUserDetail:
                  summary: Response Example
                  value:
                    id: f1e2d3c4-b5a6-7890-abcd-ef1234567890
                    tenant_id: 11223344-5566-7788-99aa-bbccddeeff00
                    app_id: a1b2c3d4-5678-90ab-cdef-1234567890ab
                    type: service_api
                    external_user_id: abc-123
                    name: null
                    is_anonymous: false
                    session_id: abc-123
                    created_at: '2024-01-16T12:00:29Z'
                    updated_at: '2024-01-16T12:00:29Z'
        '404':
          description: '`end_user_not_found` : End user not found.'
          content:
            application/json:
              examples:
                end_user_not_found:
                  summary: end_user_not_found
                  value:
                    status: 404
                    code: end_user_not_found
                    message: End user not found.
components:
  schemas:
    EndUserDetail:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: End user ID.
        tenant_id:
          type: string
          format: uuid
          description: Tenant ID.
        app_id:
          type: string
          format: uuid
          nullable: true
          description: Application ID.
        type:
          type: string
          description: End user type. Always `service_api` for Service API users.
        external_user_id:
          type: string
          nullable: true
          description: >-
            The `user` identifier provided in API requests (e.g., the `user`
            field in [Send Completion
            Message](/api-reference/completions/send-completion-message)).
        name:
          type: string
          nullable: true
          description: End user name.
        is_anonymous:
          type: boolean
          description: >-
            Whether the user is anonymous. `true` when no `user` identifier was
            provided in the original API request.
        session_id:
          type: string
          description: Session identifier. Defaults to the `external_user_id` value.
        created_at:
          type: string
          format: date-time
          description: Creation timestamp.
        updated_at:
          type: string
          format: date-time
          description: Last update timestamp.
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API_KEY
      description: >-
        API Key authentication. For all API requests, include your API Key in
        the `Authorization` HTTP Header, prefixed with `Bearer `. Example:
        `Authorization: Bearer {API_KEY}`. **Strongly recommend storing your API
        Key on the server-side, not shared or stored on the client-side, to
        avoid possible API-Key leakage that can lead to serious consequences.**

````