List Users
This API returns a list of user accounts available within the tenant.
Endpoint Details
| URL | /v1/auth/users |
| Method | GET |
| Authorization | Bearer Token |
Request Headers
| Header | Type | Description |
|---|---|---|
| Content-Type | String | Must be application/json |
Response
Here is an example of a response when viewing a list of data:
Response
{
"users": [
{
"id": "ac7a586b-a0ba-41ce-bb55-343cc8ca6838",
"tenant_id": "5ebde17c-01a1-4394-977b-9e611250cf5d",
"email": "memberaplikasi12@example.com",
"first_name": "Member",
"last_name": "Aplikasi",
"role_code": "member",
"is_active": true,
"created_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
"updated_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
"created_at": 1784013339,
"updated_at": 1784013339
},
{
"id": "d28c9ea0-3d57-4354-bfbe-8aaff6ba432a",
"tenant_id": "5ebde17c-01a1-4394-977b-9e611250cf5d",
"email": "memberaplikasi@example.com",
"first_name": "Member",
"last_name": "Aplikasi",
"role_code": "member",
"is_active": true,
"created_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
"updated_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
"created_at": 1784013117,
"updated_at": 1784013117
},
{
"id": "c9c83de5-4001-4d19-8a44-3add3ce28af7",
"tenant_id": "5ebde17c-01a1-4394-977b-9e611250cf5d",
"email": "testus@example.com",
"first_name": "Tes",
"last_name": "Tus",
"role_code": "member",
"is_active": true,
"created_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
"updated_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
"created_at": 1784012984,
"updated_at": 1784012984
},
{
"id": "210eb093-9f68-434c-9444-8ce3bb64f18b",
"tenant_id": "5ebde17c-01a1-4394-977b-9e611250cf5d",
"email": "nabiel@primasys.co.id",
"first_name": "Fawwaz",
"last_name": "Nabiel",
"role_code": "member",
"is_active": true,
"is_verified": true,
"last_login_at": 1782962626,
"created_by": "0446ea62-fb8b-4889-9c60-a2f9f13b5abc",
"updated_by": "0446ea62-fb8b-4889-9c60-a2f9f13b5abc",
"created_at": 1782962379,
"updated_at": 1782962626
},
{
"id": "14267f09-684a-423d-bb39-bc6b7e5205db",
"tenant_id": "5ebde17c-01a1-4394-977b-9e611250cf5d",
"email": "user@example.com",
"first_name": "String",
"last_name": "String",
"role_code": "stakeholder",
"is_active": true,
"created_by": "0a11c692-b992-4d02-8a55-22b005459c50",
"updated_by": "0a11c692-b992-4d02-8a55-22b005459c50",
"created_at": 1782103379,
"updated_at": 1782103379
},
{
"id": "0a11c692-b992-4d02-8a55-22b005459c50",
"tenant_id": "5ebde17c-01a1-4394-977b-9e611250cf5d",
"email": "adit@primasys.co.id",
"first_name": "Adit",
"last_name": "Adit",
"role_code": "superadmin",
"is_active": true,
"is_verified": true,
"last_login_at": 1783579751,
"created_by": "414a45e9-f194-4a8a-9876-97abb990d4d9",
"updated_by": "414a45e9-f194-4a8a-9876-97abb990d4d9",
"created_at": 1781507500,
"updated_at": 1783579751
},
{
"id": "0446ea62-fb8b-4889-9c60-a2f9f13b5abc",
"tenant_id": "5ebde17c-01a1-4394-977b-9e611250cf5d",
"email": "julian@primasys.co.id",
"first_name": "Fachmi",
"last_name": "Julian",
"role_code": "superadmin",
"is_active": true,
"is_verified": true,
"last_login_at": 1783494527,
"created_by": "33f86c93-d452-4147-9392-217caa743666",
"updated_by": "33f86c93-d452-4147-9392-217caa743666",
"created_at": 1778666447,
"updated_at": 1783494527
}
],
"pagination": {
"total": 7,
"page": 1,
"page_size": 7,
"last_page": 1
}
}
Field Descriptions
| Field | Type | Description |
|---|---|---|
| id | UUID | Unique identifier of the user |
| tenant_id | UUID | Identifier of the tenant that owns the user |
| String | Email address of the user | |
| first_name | String | First name of the user |
| last_name | String | Last name of the user |
| role_code | String | Role assigned to the user |
| is_active | Boolean | Indicates whether the user account is active |
| is_verified | Boolean | Indicates whether the user account has been verified |
| last_login_at | Integer | Timestamp of the user's last login in Unix format |
| created_by | UUID | Identifier of the user who created the account |
| updated_by | UUID | Identifier of the user who last updated the account |
| created_at | Integer | User creation timestamp in Unix format |
| updated_at | Integer | Last update timestamp in Unix format |
| total | Integer | Total number of users available |
| page | Integer | Current page number |
| page_size | Integer | Number of records returned per page |
| last_page | Integer | Total number of available pages |
info
- A valid Bearer Token is required to access this endpoint.
- The response returns all user accounts available within the tenant.
- Some fields such as
is_verifiedandlast_login_atmay not be present if the user has not yet been verified or has never logged in. - Unix timestamp fields can be converted to a human-readable date and time format as needed.