Get Users

Retrieve a paginated list of users within an organisation.

Endpoint

GET /users

Parameters

Parameter	Type	Description	Required
page	integer	The page number for pagination (default: 1)	No

Response

A successful response will return a 200 OK status code and a JSON object containing the list of users and pagination metadata.

{
  "data": [
    {
      "uuid": "a68fb6bc-c093-44f4-b175-0b9608e8d6bf",
      "name": "Jeremy Bearimy",
      "email": "[email protected]",
      "profile_picture_url": "https://storage.rockety.io/c685a05c-a2be-4931-8b6d-97f9cf7f920c/pfp/1757200818_jeremy-bearimy.png",
      "timezone": "Europe/London",
      "bio": null,
      "pronouns": "he/him",
      "location": "United Kingdom",
      "role": "Head of Timeline Operations",
      "last_heartbeat_at": "2025-10-17 00:03:25",
      "created_at": "2024-07-26 22:25:12",
      "updated_at": "2025-10-17 00:03:25"
    },
    ...
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 20,
    "total_pages": 1,
    "total_items": 10
  }
}