List Districts
GET https://ed.link/api/v2/my/districts
Retrieve a list of Districts that the current user is associated with. There is always one and only one district for a given user. There will always be exactly one district; we just refer to this as a "list" because you are receiving an array of one district, rather than the district object directly as you would in the equivalent "fetch" method. This endpoint does support standard paging a filtering query parameters, but they are almost certainly not needed.
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/districts', {
headers: {
authorization: `Bearer ${person_access_token}`
}
});
Sample Response
{
"$data": [
{
"id": "c688ba67-9389-4010-b0e5-40004aa01376",
"created_date": "2021-07-05T20:32:40.454Z",
"updated_date": "2021-07-12T21:44:23.126Z",
"name": "Gravity Falls School District",
"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
},
"identifiers": [
{
"type": "sis_id",
"value": "d5d5927f-c6ff-33e3-8a30-bc5503511efd"
},
{
"type": "state_id",
"value": "5280"
}
],
"picture_url": null,
"locale": "en",
"time_zone": "America/Los_Angeles",
"location": {},
"properties": {}
}
],
"$request": "00000000-0000-0000-0000-000000000000"
}