Subjects

Every paper belongs to one subject from our catalogue. We always mark to your marking scheme. Where we have a marking profile for the subject’s syllabus, we also apply that exam board’s conventions, so choose the subject that matches the paper.

The Subject object

{
  "id": "subj_8Hn2Qx5Lw1",
  "object": "subject",
  "name": "Physics",
  "board": "Pearson Edexcel (IGCSE / A Level)",
  "level": "IGCSE",
  "syllabus_code": "4PH1"
}

Field	Type	Description
id	string	Unique ID, prefix subj_. Pass it as subject_id when you create a paper.
object	string	Always subject.
name	string	The subject’s name.
board	string	The exam board or programme, as named in our catalogue.
level	string	The qualification level, such as IGCSE or A Level, or null.
syllabus_code	string	The board’s syllabus code, or null.

List subjects

GET /v1/subjects lists the subjects available to your account, sorted by board and then name.

Parameter	Description
query	Only subjects whose name, board or syllabus code contains this text. Case-insensitive.
limit, cursor	As described in Lists and pagination.

Subject IDs don’t change, so you can look them up once and store them. If a subject you need is missing, contact us.