Request headers
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.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.
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.All filter parameters are optional. If you pass no filters, all school groups are returned,
subject to pagination.
Pass array parameters by repeating the parameter in the query string:
groupIds=1&groupIds=2&groupIds=3.Request parameters
Pagination
Filtering
Response fields
Paginated list of groups (compact projection). For the full structure, see the
group reference.Permission requirements
Requires token authentication and the “School User Management” permission (
SchoolManageUsers).Updated: 2026-09-25 14:33 UTC