List your organization's certificates

GET/v1/certificates

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

Every certificate earned by your organization's learners — the same certificate_number and details shown on the PDF a learner can download from their own Florisage account. Filter by user_id to see one person's certificates, e.g. for a compliance audit.

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

200 · A page of certificates

{
  "data": [
    {
      "id": "8e4b2d6a-3c1f-4a79-b5d0-9f2a6c8e1b34",
      "certificate_number": "CERT-2026-0001",
      "user_id": "9d2e4a86-1c3b-4f57-a8e0-6b7c5d9f1a23",
      "course_id": "c4a9e7d0-1b2f-4a6c-8d35-7f0e9b2a4c68",
      "learner_name": "Jane Citizen",
      "course_title": "Manual Handling",
      "completed_at": "2026-03-20T04:12:00Z",
      "issued_at": "2026-03-20T04:12:00Z"
    }
  ],
  "total": 1
}

Query parameters

user_idstring · uuidquery
Only return certificates for this learner.
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 certificates
Response fields
- dataarray of Certificate
  idstring · uuid
  certificate_numberstring
  user_idstring · uuid
  course_idstring · uuidnullable
  learner_namestring
  course_titlestring
  completed_atstring · date-time
  issued_atstring · date-time
- totalinteger