Skip to main content
GET
/
v1
/
organizations
/
users
/
{user_email}
Get User
curl --request GET \
  --url https://api.mixpeek.com/v1/organizations/users/{user_email} \
  --header 'Authorization: Bearer <token>'
{
  "created_at": "2025-01-01T00:00:00Z",
  "email": "alice@example.com",
  "internal_id": "int_x1y2z3",
  "metadata": {
    "department": "ML"
  },
  "organization_id": "org_demo123",
  "role": "member",
  "status": "active",
  "updated_at": "2025-01-01T00:00:00Z",
  "user_id": "usr_a1b2c3d4e5f6g7h",
  "user_name": "Alice Smith"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication using your API key. Format: 'Bearer your_api_key'. To get an API key, create an account at mixpeek.com/start and generate a key in your account settings.

Headers

​
Authorization
string
required

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Examples:

"Bearer sk_live_abc123def456"

"Bearer sk_test_xyz789"

Path Parameters

​
user_email
string
required

Response

Successful Response

Canonical user document persisted in MongoDB.

​
internal_id
string
required

Organization internal identifier used for scoping queries.

​
organization_id
string
required

Organization public identifier for reference in APIs.

​
email
string<email>
required

Unique email address for the user.

​
user_name
string
required

Display name shown in UI and logs.

​
user_id
string

Immutable public identifier for the user.

​
role
enum<string>

Organization role controlling UI access levels.

Available options:
admin,
member,
viewer
​
status
enum<string>

Lifecycle status of the account.

Available options:
active,
suspended,
pending
​
metadata
object

Arbitrary metadata stored alongside the user record.

​
namespace_permissions
NamespacePermissions · object[]

Namespace-level roles applied across all of the user's keys.

​
created_at
string<date-time>

UTC timestamp when the user was created.

​
updated_at
string<date-time>

UTC timestamp of the latest update to the user.

​
last_login
string<date-time> | null

UTC timestamp of the last successful login.