Users API
Read and manage user and organization records.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /v1/users/me | Get the authenticated user. |
| GET | /v1/users | List users in your organization (admin permission required). |
| GET | /v1/users/:id | Get a specific user by ID. |
The User Object
User object
{
"id": "usr_8f2a1c",
"email": "buyer@example.com",
"role": "buyer",
"organizationId": "org_4b7d9e",
"createdAt": "2026-01-14T09:30:00Z"
}Get the Current User
Request
curl https://api.baalvion.com/v1/users/me \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"success": true,
"data": {
"id": "usr_8f2a1c",
"email": "buyer@example.com",
"role": "buyer",
"organizationId": "org_4b7d9e"
},
"error": null
}List Organization Users
Request
curl "https://api.baalvion.com/v1/users?page=1&limit=20" \
-H "Authorization: Bearer YOUR_API_KEY"Requires an API key belonging to an account with organization administrator permissions.