curl https://api.bota.dev/v1/end-users/eu_abc123 \
-H "Authorization: Bearer sk_live_..."
const response = await fetch('https://api.bota.dev/v1/end-users/eu_abc123', {
headers: {
'Authorization': 'Bearer sk_live_...',
},
});
const endUser = await response.json();
import requests
response = requests.get(
'https://api.bota.dev/v1/end-users/eu_abc123',
headers={'Authorization': 'Bearer sk_live_...'},
)
end_user = response.json()
{
"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"
}
{
"error": {
"code": "not_found",
"message": "End user not found"
}
}
End Users
Get End User
Retrieve details of a specific end user
GET
/
end-users
/
{id}
curl https://api.bota.dev/v1/end-users/eu_abc123 \
-H "Authorization: Bearer sk_live_..."
const response = await fetch('https://api.bota.dev/v1/end-users/eu_abc123', {
headers: {
'Authorization': 'Bearer sk_live_...',
},
});
const endUser = await response.json();
import requests
response = requests.get(
'https://api.bota.dev/v1/end-users/eu_abc123',
headers={'Authorization': 'Bearer sk_live_...'},
)
end_user = response.json()
{
"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"
}
{
"error": {
"code": "not_found",
"message": "End user not found"
}
}
Retrieve the details of an existing end user by their unique identifier.
Authentication
Requires an API key withend_users:read scope.
curl https://api.bota.dev/v1/end-users/eu_abc123 \
-H "Authorization: Bearer sk_live_..."
const response = await fetch('https://api.bota.dev/v1/end-users/eu_abc123', {
headers: {
'Authorization': 'Bearer sk_live_...',
},
});
const endUser = await response.json();
import requests
response = requests.get(
'https://api.bota.dev/v1/end-users/eu_abc123',
headers={'Authorization': 'Bearer sk_live_...'},
)
end_user = response.json()
Path Parameters
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"
}
{
"error": {
"code": "not_found",
"message": "End user not found"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the end user (prefixed with eu_). |
external_id | string | Your system’s unique identifier for this user. |
email | string | User’s email address. |
name | string | User’s display name. |
metadata | object | Arbitrary key-value metadata. |
created_at | string | ISO 8601 timestamp of when the end user was created. |
Was this page helpful?
⌘I

