Units

A Unit is a unit plan that organizes curriculum delivery within a class, containing pedagogical content such as learning objectives, assessments, and resources.

Get all Units

get

/v2/units

This endpoint retrieves all unit plans. It returns unit details including title, description, pedagogical content, and associated class IDs.

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

A timestamp to filter the modification date of results.

pagestringOptional

An integer defining which page to display.

per_pagestringOptional

An integer defining the number of records to display per page.

archivedbooleanOptional

A boolean that, if set to True, returns only archived units.

class_idsstringOptional

A comma-separated list of class IDs to filter units by.

Responses

200

Success

application/json

get/v2/units

GET /v2/units HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "units": [
    {
      "id": 1,
      "title": "Cognitive psychology",
      "description": "An exploration of cognitive processes",
      "archived": false,
      "idu_unit": null,
      "month": 1,
      "week": 1,
      "duration_in_weeks": 5,
      "hours": 1,
      "sl": true,
      "hl": true,
      "subject": {
        "id": 1,
        "name": "English"
      },
      "grade": "Grade 11",
      "grade_number": 12,
      "class_ids": [
        852
      ],
      "start_date": "2026-01-01",
      "end_date": "2026-02-05",
      "created_at": "2021-06-28T12:39:36.000Z",
      "updated_at": "2021-06-28T12:39:36.000Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "per_page": 100
  }
}

Get a Unit

get

/v2/units/{id}

This endpoint retrieves a single unit plan as specified by ID. It returns unit details including pedagogical content and associated class IDs.

Authorizations

AuthorizationstringRequired

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

Path parameters

idintegerRequired

Unique identifier for unit.

Responses

200

Success

application/json

get/v2/units/{id}

GET /v2/units/{id} HTTP/1.1
Host: api.managebac.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "unit": {
    "id": 1,
    "title": "Theory of Knowledge",
    "description": "TOK exploration",
    "archived": false,
    "sl": true,
    "hl": false,
    "subject": {
      "id": 1,
      "name": "English"
    },
    "grade": "Grade 11",
    "grade_number": 12,
    "class_ids": [
      852
    ],
    "start_date": "2026-01-01",
    "end_date": "2026-01-29",
    "created_at": "2021-06-28T12:39:36.000Z",
    "updated_at": "2021-06-28T12:39:36.000Z"
  }
}