GET https://ed.link/api/v2/my/schools
Retrieve a list of Schools that the current user is associated with. A person may be associated with any number of schools, including zero (although unlikely). Some systems that Edlink connects to do not natively support the concept of schools. In these cases, Edlink will create a default School object that will contain all of the classes.
Request Parameters
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.
This query allows for filtering results.
Sample Request
axios.get('https://ed.link/api/v2/my/schools', {
headers: {
authorization: `Bearer ${person_access_token}`
}
});
Sample Response
{
"$data": [
{
"id": "2b610fc6-a2cc-40ac-94e8-f556d451164c",
"created_date": "2025-07-08T16:04:42.901Z",
"updated_date": "2025-12-05T14:25:45.920Z",
"name": "Madison Elementary School",
"picture_url": null,
"locale": null,
"time_zone": "America/Chicago",
"grade_levels": [ "KG", "01", "02", "03", "04", "05" ],
"district_id": "2fcef336-fe50-4475-9909-626cca8114ec",
"address": {
"street": "618 Gopher Road",
"unit": null,
"postal_code": "97448",
"city": "Gravity Falls",
"state": "Oregon",
"country": "US",
"phone": "555-555-5555",
"latitude": null,
"longitude": null
},
"properties": {},
"identifiers": [
{
"type": "qmlativ_id",
"value": "2"
}
]
},
{
"id": "2b610fc6-a2cc-40ac-94e8-f556d451164c",
"created_date": "2025-07-08T16:04:42.901Z",
"updated_date": "2025-12-05T14:25:45.920Z",
"name": "Chikotee North High School",
"picture_url": null,
"locale": null,
"time_zone": "America/Chicago",
"grade_levels": [ "06", "07", "08" ],
"district_id": "2fcef336-fe50-4475-9909-626cca8114ec",
"address": {
"street": "555 Skyward Dr",
"unit": null,
"postal_code": "54482",
"city": "Stevens Point",
"state": "WI",
"country": "USA",
"phone": "5555712054",
"latitude": null,
"longitude": null
},
"properties": {},
"identifiers": [
{
"type": "qmlativ_id",
"value": "2"
}
]
},
{
"id": "2b610fc6-a2cc-40ac-94e8-f556d451164c",
"created_date": "2025-07-08T16:04:42.901Z",
"updated_date": "2025-12-05T14:25:45.920Z",
"name": "Washington Elementary School",
"picture_url": null,
"locale": null,
"time_zone": "America/Chicago",
"grade_levels": [ "09", "10", "11", "12" ],
"district_id": "2fcef336-fe50-4475-9909-626cca8114ec",
"address": {
"street": "555 Skyward Dr",
"unit": null,
"postal_code": "54482",
"city": "Stevens Point",
"state": "WI",
"country": "USA",
"phone": "5555712054",
"latitude": null,
"longitude": null
},
"properties": {},
"identifiers": [
{
"type": "qmlativ_id",
"value": "2"
}
]
}
],
"$request": "00000000-0000-0000-0000-000000000000"
}