List Users
List Users
GET
/api/portal/v1/admin/getAllUsers
Description
List every user across all accounts on the instance.
Authentication
This endpoint requires a Bearer token in the Authorization header.
- Authorization:
Bearer <token>. A valid Portal API session token or API token belonging to an administrator.
Response Schema
The endpoint returns an array of user records.
id: The unique identifier for the user.email: The user’s email address, which doubles as their login username.accountId: Theidof the account the user belongs to.isAdmin:trueif the user has administrator privileges, otherwisefalse.createdAt: Timestamp when the user was created, in milliseconds since unix epoch.
Error Responses
- 401 Unauthorized: The
Authorizationheader is missing or the token is not valid. - 403 Forbidden: The authenticated user is not an administrator.
Example Request
GET https://<your-host>:9909/api/portal/v1/admin/getAllUsers
Authorization: Bearer <token>
Example Response
Status Code: 200 OK
Response Body:
[
{
"id": 1,
"email": "admin",
"accountId": 1,
"isAdmin": true,
"createdAt": 1736942400000
},
{
"id": 7,
"email": "example@zydromarine.com",
"accountId": 42,
"isAdmin": false,
"createdAt": 1736942400000
}
]