Skip to main content
GET
/
end-users
/
{id}
curl https://api.bota.dev/v1/end-users/eu_abc123 \
  -H "Authorization: Bearer sk_live_..."

{
  "id": "eu_abc123",
  "external_id": "user_12345",
  "email": "john@example.com",
  "name": "John Doe",
  "metadata": {
    "plan": "pro",
    "department": "sales"
  },
  "created_at": "2025-01-15T10:30:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.bota.dev/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve the details of an existing end user by their unique identifier.

​
Authentication

Requires an API key with end_users:read scope. 
curl https://api.bota.dev/v1/end-users/eu_abc123 \
  -H "Authorization: Bearer sk_live_..."

​
Path Parameters

​
id
string
required
The end user’s unique identifier (e.g., eu_abc123).

​
Response

Returns the end user object. 
{
  "id": "eu_abc123",
  "external_id": "user_12345",
  "email": "john@example.com",
  "name": "John Doe",
  "metadata": {
    "plan": "pro",
    "department": "sales"
  },
  "created_at": "2025-01-15T10:30:00Z"
}

​
Response Fields

FieldTypeDescription
idstringUnique identifier for the end user (prefixed with eu_).
external_idstringYour system’s unique identifier for this user.
emailstringUser’s email address.
namestringUser’s display name.
metadataobjectArbitrary key-value metadata.
created_atstringISO 8601 timestamp of when the end user was created.