A subject object represents an Assembly Platform subject. These subjects are mapped to one or multiple subjects within a school's MIS and are used to normalise school to school variance in subject naming to a known and fixed set within the Assembly Platform.

Access: This is a read-only resource managed by Assembly (though mappings must be managed by the individual school).

List Subjects

Returns a list of the Assembly Platform's subjects.


GET /subjects
Accept: application/vnd.assembly+json; version=1
Authorization: Bearer b2s7a9s8BQokikJOvBiI2HlWgH4olfQ2
Parameter Default Example Description
per_page 100 25

number of results to return

page 1 2

page number to return

URI Template: /subjects{?per_page,page}

Response 200

Content-Type: application/json; charset=utf-8
    "object": "list",
    "total_count": 2,
    "total_pages": 1,
    "current_page": 1,
    "prev_page": null,
    "next_page": null,
    "data": [
            "object": "subject",
            "id": 1,
            "name": "Mathematics",
            "code": "MAT"
            "object": "subject",
            "id": 2,
            "name": "English",
            "code": "ENG"