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.
| Parameter | Location | Type | Description |
|---|---|---|---|
$first | query | number | Returns the first n elements from the list. |
$last | query | number | Returns the last n elements from the list. |
$before | query | uuid | Returns the elements in the list that come before the specified item. |
$after | query | uuid | 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.
Read More About Paging
Developer Guide
Click to Read
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"
}
