Unit Class Assignments

A Unit-Class Assignment is the link between a unit and a class, recording whether the unit is published (active) or in draft within that class.

List Unit-Class Assignments

get

/v2/unit-class-assignments

Returns a paginated list of unit-class assignment records for the authenticated school. Each record describes a single unit's status (active or draft) within a single class. Designed for incremental sync: pass modified_since to receive only assignments created or updated after a given time, or pass deleted_since to receive only assignments soft-deleted after a given time. The two parameters are mutually exclusive.

Authorizations

AuthorizationstringRequired

OAuth 2.0 Bearer token obtained via client credentials grant. Pass the token in the Authorization header as Bearer <token>.

Query parameters

modified_sincestringOptional

ISO 8601 timestamp; returns only assignments updated strictly after this time. Mutually exclusive with deleted_since.

deleted_sincestringOptional

ISO 8601 timestamp; returns only assignments deleted strictly after this time. Mutually exclusive with modified_since. Records returned in this mode include deleted_at and omit status / updated_at.

archivedbooleanOptional

When true, returns assignments tied to archived units; when false or omitted, returns assignments tied to non-archived units. Mirrors the same parameter on GET /v2/units. Applies to modified_since mode only — deleted_since always returns every soft-deleted assignment (including orphans whose underlying unit was hard-deleted) regardless of this parameter, so clients can clean up local storage.

pageintegerOptional

Page number (default 1).

per_pageintegerOptional

Items per page (default 100, min 1, max 500).

Responses

200

Success

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

get/v2/unit-class-assignments

GET /v2/unit-class-assignments HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "unit_class_assignments": [
    {
      "id": 78901,
      "unit_id": 1234567,
      "class_id": 456789,
      "status": "active",
      "created_at": "2025-09-01T08:00:00.000Z",
      "updated_at": "2026-04-02T14:33:00.000Z"
    },
    {
      "id": 78902,
      "unit_id": 1234568,
      "class_id": 456790,
      "status": "draft",
      "created_at": "2026-03-15T10:00:00.000Z",
      "updated_at": "2026-04-01T09:11:00.000Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 2,
    "per_page": 100,
    "modified_since": "2026-04-01T00:00:00Z",
    "deleted_since": null
  }
}