GET /api/v1/subjects

List subjects

Returns the subjects available on your subscription, each with its topics.

Parameters

Name	Type	Required	Description
`location`	string	optional	Filter by curriculum location, e.g. `AU_NSW`, `AU_VIC`, `IB`
`level`	string	optional	Filter by level, e.g. `SENIOR`

Returns

A subjects array. Each subject has id, name, location, level, and its topics.

International Baccalaureate (IB): IB Diploma subjects are returned with location: "IB", level: "SENIOR", and the Higher/Standard level encoded in the name — e.g. "IB Biology HL", "IB Mathematics Analysis and Approaches SL". As with every curriculum, the subjects you receive are governed by your subscription’s granted subjects.

cURL

curl "https://ai.intu.com.au/api/v1/subjects?location=AU_NSW" \
  -H "Authorization: Token token=sk_intu_api_<your_api_key>"

Response

{
  "subjects": [
    {
      "id": "b1d9b7d4-06bc-45d1-95af-a441eb9b928b",
      "name": "HSC Biology",
      "location": "AU_NSW",
      "level": "SENIOR",
      "topics": [
        { "id": "d85701b5-f957-4219-8bbf-eb3400f73990", "name": "Heredity", "year_levels": ["12"] }
      ]
    }
  ]
}