For Developers

List Calendars

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

Retrieve a list of all Calendars.

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

Sample Response

{
    "$data": [
        {
            "id": "00000000-0000-0000-0000-000000000000",
            "created_date": "2022-04-14T10:45:27.570Z",
            "updated_date": "2022-04-14T10:45:27.570Z",
            "properties": {},
            "name": "Attendance Calendar",
            "code": "ATT-CAL",
            "start_date": "2022-08-01T00:00:00.000Z",
            "end_date": "2023-07-31T23:59:59.999Z",
            "state": "active",
            "flags": ["attendance"],
            "type": "standard",
            "school_ids": ["55555555-5555-5555-5555-555555555555", "66666666-6666-6666-6666-666666666666"]
        },
        {
            "id": "11111111-1111-1111-1111-111111111111",
            "created_date": "2022-04-14T10:45:27.570Z",
            "updated_date": "2022-04-14T10:45:27.570Z",
            "properties": {},
            "name": "School Year 2025",
            "code": "SCH-YR-2025",
            "start_date": "2025-08-01T00:00:00.000Z",
            "end_date": "2026-07-31T23:59:59.999Z",
            "state": "active",
            "flags": [],
            "type": "standard",
            "school_ids": ["55555555-5555-5555-5555-555555555555", "66666666-6666-6666-6666-666666666666"]
        },
        {
            "id": "22222222-2222-2222-2222-222222222222",
            "created_date": "2022-04-14T10:45:27.570Z",
            "updated_date": "2022-04-14T10:45:27.570Z",
            "properties": {},
            "name": "School Year 2024",
            "code": "SCH-YR-2024",
            "start_date": "2024-08-01T00:00:00.000Z",
            "end_date": "2025-07-31T23:59:59.999Z",
            "state": "inactive",
            "flags": [],
            "type": "standard",
            "school_ids": ["55555555-5555-5555-5555-555555555555", "66666666-6666-6666-6666-666666666666"]
        }
    ],
    "$request": "00000000-0000-0000-0000-000000000000"
}