# Get users

This endpoint return users

About

Retrieves all users associated with the authenticated account. Supports pagination and role-based filtering.

Example

  • List all users (with pagination)
curl -X GET "https://api.picussecurity.com/v1/users?offset=0&limit=25" \
  -H "Access-Token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"
{
  "users": [
    {
      "email": "[email protected]",
      "user_id": 1001,
      "role": "Admin",
      "role_id": 1,
      "name": "John Doe",
      "surname": "Doe",
      "is_active": true
    },
    {
      "email": "[email protected]",
      "user_id": 1002,
      "role": "Viewer",
      "role_id": 3,
      "name": "Jane Smith",
      "surname": "Smith",
      "is_active": true
    }
  ],
  "pages": {
    "offset": 0,
    "limit": 25,
    "total_pages": 3,
    "total_count": 67
  }
}
  • List users with role filter
curl -X GET "https://api.picussecurity.com/v1/users?role=Admin&offset=0&limit=10" \
  -H "Access-Token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"
{
  "users": [
    {
      "email": "[email protected]",
      "user_id": 1001,
      "role": "Admin",
      "role_id": 1,
      "name": "John Doe",
      "surname": "Doe",
      "is_active": true
    }
  ],
  "pages": {
    "offset": 0,
    "limit": 25,
    "total_pages": 1,
    "total_count": 15
  }
}

Language
Credentials
Header
Click Try It! to start a request and see the response here!