List users

Users with login, email, department, groups and status.

GET https://cotlet.dev/api/v1/ispring/users

read

Lists users in pages; pass next_cursor back as cursor for the next page. status is active or inactive; inactive users cannot sign in, so an enrollment for them is refused. Without department or group the whole account is searched, within the departments your role manages.

Parameters

Parameters: list_users
NameTypeDescription
query string string Name, login or email.
department_id string string Only users of this department and its sub-departments.
group_id string string Only members of this group.
status enum enum active (default) or inactive.
limit integer integer Users per page.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/ispring/users \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("ispring", "list_users")
Node.js
const result = await cotlet.call('ispring', 'list_users');
CLI
cotlet call ispring list_users

Example response

JSON

{
  "users": [
    {
      "user_id": "u_81c2d4",
      "name": "Ana Lopez",
      "login": "ana.lopez",
      "email": "ana.lopez@example.com",
      "department": "Sales",
      "groups": [
        "New hires 2026"
      ],
      "status": "active"
    },
    {
      "user_id": "u_81c2e9",
      "name": "Tom Becker",
      "login": "tom.becker",
      "email": "tom.becker@example.com",
      "department": "Sales",
      "groups": [],
      "status": "active"
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.