For Developers

List Requests

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

Retrieve a list of all requests.

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

// List the 5 most recent requests.
axios.get('https://ed.link/api/v2/graph/requests?$last=5', {
    headers: {
        authorization: `Bearer ${integration_access_token}`
    }
});

Sample Response

{
    "$data": [
        {
            "date": "2025-09-09T14:38:42.494Z",
            "start_date": "2025-09-09T14:38:42.477Z",
            "end_date": "2025-09-09T14:38:42.493Z",
            "method": "POST",
            "path": "/api/authentication/token",
            "status": 200,
            "properties": {
                "ip": "00.00.000.00",
                "query": {},
                "api_server": "10.96.2.110",
                "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36"
            },
            "input": {
                "client_id": "36ad8864-d789-45b6-9df8-334c2f32445b",
                "grant_type": "refresh_token",
                "client_secret": "pT0...hww",
                "refresh_token": "a5c...32d"
            },
            "output": {
                "$data": {
                    "expires_in": 3600,
                    "token_type": "Bearer",
                    "access_token": "17a...268",
                    "refresh_token": "a5c...32d"
                },
                "$request": "31b75cc2-b1ba-4777-acfa-c94c9938e888"
            },
            "idempotency_key": null,
            "categories": ["sso"],
            "person_id": "280e099c-9a2a-4b19-be0f-599fcae2beef",
            "integration_id": "45294ee8-baad-4221-9c4b-da41beae5967",
            "developer_id": "3943245f-7033-4f5f-a32c-861effdc64b7",
            "district_id": "2ef97a26-bd09-44d4-97f5-37135fa0660d",
            "user_id": "280e099c-9a2a-4b19-be0f-599fcae2beef",
            "id": "31b75cc2-b1ba-4777-acfa-c94c9938e888"
        },
        {
            "date": "2025-09-09T14:38:42.566Z",
            "start_date": "2025-09-09T14:38:42.529Z",
            "end_date": "2025-09-09T14:38:42.564Z",
            "method": "POST",
            "path": "/api/authentication/token",
            "status": 200,
            "properties": {
                "ip": "00.00.000.00",
                "query": {},
                "api_server": "10.96.2.124",
                "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36"
            },
            "input": {
                "code": "JR6...7Vl",
                "client_id": "36ad8864-d789-45b6-9df8-334c2f32445b",
                "grant_type": "authorization_code",
                "redirect_uri": "https://ed.link/demo/code",
                "client_secret": "pT0...hww"
            },
            "output": {
                "$data": {
                    "context": {
                        "class": {
                            "id": "6b340991-04bc-48ba-9b1e-6a13b4ece00b",
                            "name": "Math 101",
                            "state": "active",
                            "locale": null,
                            "periods": [],
                            "room_ids": [],
                            "rule_ids": [],
                            "subjects": [],
                            "course_id": "d44df0f2-c3c8-4815-a2a3-dfacc53773b9",
                            "school_id": "d9851037-1ecf-4a8a-b490-59cd2b62cc7f",
                            "time_zone": "America/Chicago",
                            "period_ids": [],
                            "properties": {},
                            "references": {
                                "meetings": 0,
                                "sections": 0,
                                "enrollments": 5
                            },
                            "subject_id": null,
                            "description": null,
                            "identifiers": [
                                {
                                    "type": "canvas_id",
                                    "value": "2"
                                }
                            ],
                            "picture_url": null,
                            "product_ids": [],
                            "session_ids": ["915d1210-0016-4118-8a13-61f6d706bfe4"],
                            "created_date": "2024-06-10T20:16:03.380Z",
                            "grade_levels": [],
                            "updated_date": "2025-04-01T21:09:00.015Z",
                            "department_id": null
                        },
                        "custom": {
                            "class_external_id": "3",
                            "person_external_id": "4",
                            "assignment_external_id": "$Canvas.assignment.id",
                            "submission_external_id": "$com.instructure.Submission.id"
                        },
                        "intent": "class",
                        "version": 2
                    },
                    "expires_in": 3600,
                    "token_type": "Bearer",
                    "access_token": "1f0...537",
                    "refresh_token": "362...6d3"
                },
                "$request": "50afb3c6-62cf-48eb-9ef2-2c4c71d27e11"
            },
            "idempotency_key": null,
            "categories": ["sso"],
            "person_id": "280e099c-9a2a-4b19-be0f-599fcae2beef",
            "integration_id": "45294ee8-baad-4221-9c4b-da41beae5967",
            "developer_id": "3943245f-7033-4f5f-a32c-861effdc64b7",
            "district_id": "69cf5da1-c698-423e-bbb3-fc1f3a7d0527",
            "user_id": "280e099c-9a2a-4b19-be0f-599fcae2beef",
            "id": "50afb3c6-62cf-48eb-9ef2-2c4c71d27e11"
        },
        {
            "date": "2025-09-09T14:38:42.612Z",
            "start_date": "2025-09-09T14:38:42.602Z",
            "end_date": "2025-09-09T14:38:42.611Z",
            "method": "GET",
            "path": "/api/v2/my/profile",
            "status": 200,
            "properties": {
                "ip": "00.00.000.00",
                "query": {},
                "api_server": "Unknown",
                "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/139.0.0.0 Safari/537.36"
            },
            "input": {},
            "output": {
                "$data": {
                    "id": "280e099c-9a2a-4b19-be0f-599fcae2beef",
                    "gpa": null,
                    "email": "dakota@ed.link",
                    "phone": null,
                    "roles": ["teacher"],
                    "locale": null,
                    "address": {
                        "city": null,
                        "unit": null,
                        "state": null,
                        "street": null,
                        "country": null,
                        "postal_code": null
                    },
                    "rule_ids": [],
                    "last_name": "Gordon",
                    "time_zone": null,
                    "first_name": "Dakota",
                    "properties": {},
                    "school_ids": ["36a906a1-7c7b-46fc-aaa1-7d94ec7ae686", "5c612a2f-0639-461b-951b-ea3b1434c081", "8c83c7b1-f522-4748-a6a3-1b2d3dd229f9", "bec95c67-ebbe-49a1-8a41-5a5264e77970"],
                    "district_id": "69cf5da1-c698-423e-bbb3-fc1f3a7d0527",
                    "identifiers": [
                        {
                            "type": "canvas_id",
                            "value": "4"
                        },
                        {
                            "type": "username",
                            "value": "dakota@ed.link"
                        }
                    ],
                    "middle_name": null,
                    "picture_url": null,
                    "product_ids": [],
                    "created_date": "2024-06-10T20:16:03.504Z",
                    "demographics": {
                        "races": [],
                        "gender": null,
                        "migrant": null,
                        "birthday": null,
                        "homeless": null,
                        "disability": null,
                        "city_of_birth": null,
                        "state_of_birth": null,
                        "gifted_talented": null,
                        "rural_residency": null,
                        "country_of_birth": null,
                        "primary_language": null,
                        "residence_status": null,
                        "public_assistance": null,
                        "military_connected": null,
                        "special_accommodations": null,
                        "english_language_learner": null,
                        "economically_disadvantaged": null,
                        "hispanic_or_latino_ethnicity": null,
                        "individualized_education_plan": null,
                        "food_service_program_eligibility": null
                    },
                    "display_name": "Dakota Gordon",
                    "grade_levels": [],
                    "letter_grade": null,
                    "updated_date": "2025-09-04T01:21:30.889Z",
                    "department_ids": [],
                    "graduation_year": null
                },
                "$request": "fa1578ee-c847-4091-972b-0640ac1e096a"
            },
            "idempotency_key": null,
            "categories": ["user", "rostering"],
            "person_id": "280e099c-9a2a-4b19-be0f-599fcae2beef",
            "integration_id": "45294ee8-baad-4221-9c4b-da41beae5967",
            "developer_id": "3943245f-7033-4f5f-a32c-861effdc64b7",
            "district_id": "2ef97a26-bd09-44d4-97f5-37135fa0660d",
            "user_id": "280e099c-9a2a-4b19-be0f-599fcae2beef",
            "id": "fa1578ee-c847-4091-972b-0640ac1e096a"
        }
    ],
    "$request": "18c65f6d-a6fb-4a40-81e4-617691026c76"
}