Skip to main content
GET
/
admin
/
users
List organization users
curl --request GET \
  --url https://asteragents.com/api/admin/users \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "user_2ABC123DEF",
      "email": "john.doe@company.com",
      "firstName": "John",
      "lastName": "Doe",
      "username": "johndoe",
      "profileImageUrl": "https://img.clerk.com/profile.jpg",
      "role": "org:admin",
      "publicMetadata": {
        "department": "engineering",
        "title": "Senior Engineer"
      },
      "joinedAt": 1704182400000,
      "lastSignInAt": 1705363800000,
      "createdAt": 1701417600000
    },
    {
      "id": "user_2XYZ789GHI",
      "email": "sarah.smith@company.com",
      "firstName": "Sarah",
      "lastName": "Smith",
      "username": null,
      "profileImageUrl": "https://img.clerk.com/avatar.jpg",
      "role": "org:member",
      "publicMetadata": {
        "department": "marketing"
      },
      "joinedAt": 1704787200000,
      "lastSignInAt": 1705276800000,
      "createdAt": 1704787200000
    }
  ],
  "totalCount": 15
}

Authorizations

​
Authorization
string
header
required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Query Parameters

​
limit
integer
default:10

Number of results to return

Required range: 1 <= x <= 500
​
offset
integer
default:0

Number of results to skip for pagination

Required range: x >= 0
​
role
enum<string>

Filter by organization role

Available options:
org:admin,
org:member
​
orderBy
string
default:-created_at

Sort field and direction (prefix with - for descending, + for ascending)

Examples:

"-created_at"

"+email"

"-last_sign_in_at"

Response

Successfully retrieved users

​
data
object[]
required
​
totalCount
integer
required

Total number of active users in the organization