List learners

List learners with their groups and the date they were added.

GET https://cotlet.dev/api/v1/workramp/learners

read

Returns the name, email, groups and manager of each learner, 30 to a page. The learner_id feeds the assignment tools. The filters work within each page, so follow next_cursor until the dates fall outside your window.

Parameters

Parameters: list_learners
NameTypeDescription
group string string Group name.
joined_since string string ISO date; only learners added on or after it.
cursor string string Next page cursor from the previous call.

Request

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

Example response

JSON

{
  "learners": [
    {
      "learner_id": "usr_31f0a2",
      "name": "Tom Becker",
      "email": "tom@example.com",
      "groups": [
        "Sales"
      ],
      "manager": "Maya Chen",
      "added_at": "2026-10-19"
    }
  ],
  "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.