End Users

Get End User Info

Available for: Chatflow, Workflow, Agent, Chatbot, Legacy Agent, Text Generator apps.

Returns an end user's details by ID. Useful for resolving an end-user ID returned by another endpoint, such as created_by in the Upload File response.

get/end-users/{end_user_id}

Request

  • Base URL
    https://api.dify.ai/v1
  • URL
    https://api.dify.ai/v1/end-users/{end_user_id}
  • Auth
    HTTP bearer

Path parameters

end_user_idstring uuid required

ID of the end user to look up.

Response

End user retrieved successfully.

app_idstring uuid nullable

Application ID.

created_atstring date-time

Creation timestamp.

external_user_idstring nullable

The user identifier provided in API requests (e.g., the user field in Send Chat Message).

idstring uuid

End user ID.

is_anonymousboolean

Whether the user is anonymous. true when no user identifier was provided in the original API request.

namestring nullable

End user name.

session_idstring

Session identifier. Defaults to the external_user_id value.

tenant_idstring uuid

Tenant ID.

typestring

End user type. Always service-api for Service API users.

updated_atstring date-time

Last update timestamp.

Changes

No recorded changes to this operation across all 17 revisions of this API.