For Developers

List Departments

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

Retrieve a list of all Departments.

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/departments', {
    headers: {
        authorization: `Bearer ${integration_access_token}`
    }
});

Sample Response

{
    "$data": [
        {
            "id": "a43869b2-e519-4231-b9b2-bb5dedabbdb7",
            "created_date": "2021-07-13T17:45:27.570Z",
            "updated_date": "2021-07-13T17:45:27.570Z",
            "properties": {},
            "name": "Department of Mathematics",
            "description": "Home of all Mathmatical and Statistical Studies",
            "school_ids": ["a3303522-8747-456e-8dda-a4079dc32409"],
            "identifiers": [
                {
                    "type": "sis_id",
                    "value": "151"
                }
            ]
        },
        {
            "id": "b54969b2-e519-4231-b9b2-bb5dedabbdb8",
            "created_date": "2021-07-14T10:20:30.123Z",
            "updated_date": "2021-07-14T10:20:30.123Z",
            "properties": {},
            "name": "Department of Science",
            "description": "Home of all Scientific Studies",
            "school_ids": ["a3303522-8747-456e-8dda-a4079dc32409"],
            "identifiers": [
                {
                    "type": "sis_id",
                    "value": "152"
                }
            ]
        }
    ],
    "$request": "00000000-0000-0000-0000-000000000000"
}