Part3 Developers

Users list

GET /users

List users platform-wide

GET
/users
AuthorizationBearer <token>

In: header

Query Parameters

cursor?string

Pagination cursor — pass back nextCursor from a prior response.

limit?string

Page size (1–50, default 25).

sortBy?string

Sort field. createdAt (default), name, or email.

sortOrder?string

Sort direction. desc (default) or asc.

Value in"asc" | "desc"
search?string

Free-text search by name or email (case-insensitive ILIKE).

Lengthlength <= 500
filter.name?string

Filter by exact name match.

Lengthlength <= 500
filter.email?string

Filter by exact email match.

Lengthlength <= 500
filter.createdAt?string

Filter by creation date (ISO).

Lengthlength <= 25
activitySummary?string

Attach activity-summary buckets to each row. weekly = 7×1day, monthly = 4×7day, yearly = 12×1month. Activity = recorded actions (document work, comments, tracked events).

Value in"weekly" | "monthly" | "yearly"
includeMeta?string

When true, include meta.filters with filter enum values for UI controls.

Value in"true"

Response Body

application/json

application/json

curl -X GET "https://api.part3.io/v1/users"
{
  "data": [
    {
      "uid": "user_99a8b7c6d5",
      "name": "Anika Patel",
      "email": "anika@example.com",
      "enabledMfa": true,
      "notificationPreference": "1",
      "createdAt": "2026-01-08T19:24:00Z",
      "orgCount": 2,
      "projectCount": 14,
      "lastActivity": "2026-04-22T11:02:33Z"
    }
  ],
  "nextCursor": null,
  "hasMore": false
}
{
  "error": "User not found"
}