List Certificates

Retrieve a paginated list of certificates issued on the course, newest first.

Request

GET /players/{id}/analytics/certificates

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Course UUID. See Identifiers.

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number. A missing, non-numeric, zero, or negative value is treated as 1. A page past the end returns an empty data array and 200.
per_page	integer	25	Items per page (min: 1, max: 100). Anything else is 422.
query	string	—	Case-insensitive part of the printed name, an exact certificate id, or an issue date YYYY-MM-DD. Longer than 255 characters is 422.

Example Request

curl -X GET "https://app.easy.tools/api/v1/players/8f3c1a62-d047-4e89-9b25-1c6a4d8e0f71/analytics/certificates?page=1&per_page=25" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Response

Success Response (200)

{
  "data": [
    {
      "id": "V1StGXR8_Z5jdHi6B-myT",
      "full_name": "John Smith",
      "issued_at": "2026-05-02T16:30:00.000Z",
      "public_url": "https://app.easy.tools/players/course-intro/certificates/V1StGXR8_Z5jdHi6B-myT"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 1,
    "per_page": 25,
    "total": 1
  }
}

Response Fields

Each entry in data has the fields described in Certificate Object. id is the value Regenerate Certificate takes.

Pagination Object

See Pagination Object. total is the number of certificates that match query.

Error Responses

Not Found Error (404)

See Identifiers.

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Resource not found"
  }
}

Validation Error (422 Unprocessable Entity)

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The given data was invalid",
    "details": {
      "per_page": ["per_page must not be greater than 100"]
    }
  }
}

Authentication, permission, and rate-limit errors are described in Authorization.