For Developers

Institutions Overview

An Edlink Institution represents a learning organization in the Public Data API, such as a school, district, college, or university. Institutions can be linked to one another through parent/child relationships.

Properties

PropertyTypeDescription
idstringThe UUID for the object.
$filter operators: equals in not in
namestringThe institution's name.
$filter operators: equals starts with contains in not in is known is unknown
typestringThe institution type. One of school, district, college, university, lea, government, organization, or other.
$filter operators: equals in not in is known is unknown
descriptorstringA short label or qualifier for the institution.
$filter operators: equals starts with contains in not in is known is unknown
websitestringThe institution's website URL.
$filter operators: equals starts with contains in not in is known is unknown
descriptionstringA longer description of the institution.
$filter operators: equals starts with contains in not in is known is unknown
logostringA URL for the institution's logo.
addressesobject[]The institution's addresses. Included when addresses are populated on the response.

Address Properties

Each entry in addresses has the following properties:

PropertyTypeDescription
idstringThe UUID for the address.
typestringThe address type. One of physical, mailing, post_office_box, billing, shipping, headquarters, branch, or other.
streetstringThe street address.
unitstringThe unit, suite, or apartment number.
postal_codestringThe postal or ZIP code.
citystringThe city.
statestringThe state or province.
countrystringThe country.
latitudenumberThe latitude coordinate.
longitudenumberThe longitude coordinate.

JSON Example

{
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "Lincoln Elementary School",
    "type": "school",
    "descriptor": null,
    "website": "https://lincoln.example.edu",
    "description": "A public elementary school serving grades K-5.",
    "logo": null,
    "addresses": [
        {
            "id": "11111111-1111-1111-1111-111111111111",
            "type": "physical",
            "street": "123 Main Street",
            "unit": null,
            "postal_code": "62701",
            "city": "Springfield",
            "state": "IL",
            "country": "US",
            "latitude": 39.7817,
            "longitude": -89.6501
        }
    ]
}