For Developers

List Subjects

GET https://ed.link/api/v2/graph/subjects

Retrieve a list of all Subjects.

Request Parameters

This query allows for filtering results.

This query allows for standard paging parameters.

ParameterLocationTypeDescription
$firstquerynumber

Returns the first n elements from the list.

$lastquerynumber

Returns the last n elements from the list.

$beforequeryuuid

Returns the elements in the list that come before the specified item.

$afterqueryuuid

Returns the elements in the list that come after the specified item.

It is best practice to use either $first or $last in conjunction with the $next value returned by the API to paginate through results.

Sample Request

axios.get('https://ed.link/api/v2/graph/subjects', {
    headers: {
        authorization: `Bearer ${integration_access_token}`
    }
});

Sample Reponse

{
    "$data": [
        {
            "id": "4f099c36-4533-5b30-9f1a-cf50fa5fec64",
            "code": "CHEM-102",
            "ceds_code": "CEDS.03",
            "description": "Some extra text",
            "created_date": "2023-05-04T21:57:53.814Z",
            "updated_date": "2025-08-07T22:34:43.814Z",
            "name": "Chemistry II",
            "properties": {},
            "identifiers": [],
            "department_id": "9c529a86-fbd4-5667-994a-0f41218fb0b7"
        },
        {
            "id": "0d09e3be-8baf-5ec7-84ff-2e8148640a76",
            "code": "CALC-101",
            "ceds_code": "CEDS.02",
            "description": "A description of the subject.",
            "created_date": "2021-07-13T17:45:27.570Z",
            "updated_date": "2021-07-13T17:45:27.570Z",
            "name": "Calculus I",
            "properties": {},
            "identifiers": [],
            "department_id": "9c529a86-fbd4-5667-994a-0f41218fb0b7"
        }
    ],
    "$request": "00000000-0000-0000-0000-000000000000"
}