#divisions v2.4.1
JD
john@divisions.dev
API Docs › Endpoints › GET /users

Retrieve Users

Fetch a paginated list of users from the #divisions platform. Supports filtering by status, role, and creation date.

GET /get/users
Operational

Returns a JSON array of user objects. Requires read:users scope.

Query Parameters

Parameter Type Required Description
page integer No Page number for pagination (default: 1)
limit integer No Results per page (default: 20, max: 100)
status string No Filter by account status: active, inactive, pending
role string No Filter by user role: admin, editor, viewer
sort_by string No Sort field: created_at, name, last_login 
curl https://api.divisions.dev/v2/get/users?page=1\&limit=20\&status=active \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
const response = await fetch('https://api.divisions.dev/v2/get/users', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
import requests

headers = {"Authorization": f"Bearer {API_KEY}"}
params = {"page": 1, "limit": 20}

response = requests.get("https://api.divisions.dev/v2/get/users", headers=headers, params=params)
data = response.json()
{
  "success": true,
  "data": [
    {
      "id": "usr_8x92k41m",
      "name": "Sarah Kim",
      "email": "sarah@novatech.io",
      "role": "admin",
      "status": "active",
      "created_at": "2024-08-12T14:22:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 142
  }
}

Live Preview

🔍
User Role Status Last Login Actions