Request headers
string
required
The service user’s API token in the
Bearer YOUR_TOKEN format. The school owner issues the token in the admin panel:
Manage → School → For developers → API keys — see the “Authentication” section for details.integer
required
The numeric ID of the seller — the account the school belongs to. Copy it on the API keys page, in
the Integration data → Identifiers card. The token’s permissions are checked against this ID.
integer
required
The numeric ID of the school, found in the same place as
Seller-Id. The value must match the seller’s school — otherwise
a 400 error with cause: "ForbiddenSchoolMismatch" is returned.Returns certificates issued for the school’s courses. All filter parameters are optional — without them
the method returns all of the school’s certificates page by page, from newest to oldest (by descending
certificateId).
Array parameters are passed by repeating the parameter: courseIds=1&courseIds=2.Request parameters
Pagination
integer
Number of records to skip. Defaults to
0.integer
Page number (an alternative to
skip). Starts at 1.integer
Number of records per page. From
1 to 1000. Defaults to 100.Filtering
integer[]
Filter by certificate IDs.
integer[]
Filter by IDs of the courses the certificate was issued for.
integer[]
Filter by recipient user IDs.
integer[]
Filter by group IDs. A group is linked to the recipient, not to the certificate: the results include
certificates of users who are members of at least one of the specified groups.
object
Issue date range.
boolean
Filter by the certificate’s archived state:
true — archived only, false — non-archived only. If omitted,
both are returned.Response fields
object
Paginated list of certificates (compact projection). The full structure is in the
certificate reference.Permission requirements
Requires token authentication and one of the permissions: “Course Management” (
CourseManage)
or “Course Student Management” (CourseStudentManage).Updated: 2026-09-25 14:33 UTC