List your organization's learners

GET/v1/users

Needs a bearer access token with the users.read scope. How authentication works

Everyone currently on your organization's own learner list — never another organization's. Useful for looking up a user_id to filter /v1/enrolments or /v1/certificates by, or just to check who's already in Florisage before calling POST /v1/enrolments for them.

curl -X GET "https://florisage.com/api/v1/users" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

200 · A page of users

{
  "data": [
    {
      "id": "9d2e4a86-1c3b-4f57-a8e0-6b7c5d9f1a23",
      "email": "jane.citizen@example.com",
      "first_name": "Jane",
      "last_name": "Citizen",
      "mobile": null,
      "role": "learner",
      "status": "active",
      "organization_id": "5e8f1a3c-7b9d-4c2e-b6a4-0d1f3e5a7c92",
      "created_at": "2026-03-14T09:30:00Z"
    }
  ],
  "total": 1
}

Query parameters

limitintegerquery
Page size. Default 25, maximum 100.
offsetintegerquery
How many results to skip before the first one returned. Maximum 10,000.

Responses

200A page of users
Response fields
- dataarray of User
  idstring · uuid
  emailstring
  first_namestring
  last_namestring
  mobilestringnullable
  rolestring
  statusstring
  organization_idstring · uuidnullable
  created_atstring · date-time
- totalinteger