For Developers

People Overview

A Person within a data source.

Properties

PropertyTypeDescription
idstringThe UUID for the object.
$filter operators: equals in not in
created_dateDateWhen the object was first seen by Edlink.
updated_dateDateWhen the object was last changed in Edlink.
$filter operators: equals gt lt gte lte
first_namestringThe person's first name.
$filter operators: equals starts with contains in not in is known is unknown
middle_namestringThe person's middle name.
last_namestringThe person's last name.
$filter operators: equals starts with contains in not in is known is unknown
display_namestringThe person's display name.
$filter operators: equals starts with contains in not in is known is unknown
picture_urlstringThe URL for the person's profile picture.
rolesRole[]The person's roles. Note that not every data source has roles for a person.
emailstringThe person's email address. Many data sources do not require any sort of email verification for this field, so use caution.
$filter operators: equals starts with contains
phonestringThe person's phone number.
localestringThe locale of the object.
time_zoneTimezoneThe tz database name of the object.
gpanumberThe person's GPA.
letter_gradestringThe person's overall letter grade.
graduation_yearnumberThe person's expected graduation year.
grade_levelsGradeLevel[]The grade levels this person is associated with.
demographicsDemographicsThe person's demographics.
addressAddressThe person's primary address.
propertiesobjectNon-standard properties that may be of interest to the developer.
identifiersIdentifier[]Additional IDs associated with the object.
district_idstringThe UUID of the associated District.
school_idsstring[]The UUIDs of the associated Schools.
department_idsstring[]The UUIDs of the associated Departments.
route_idsstring[]The UUIDs of the associated bus Routes.

JSON Example

{
    "id": "00000000-0000-0000-0000-000000000000",
    "created_date": "2021-07-13T17:45:39.937Z",
    "updated_date": "2021-07-13T17:45:39.937Z",
    "first_name": "George",
    "middle_name": "Oscar",
    "last_name": "Bluth",
    "display_name": "Gob Bluth",
    "picture_url": "https://static.wikia.nocookie.net/arresteddevelopment/images/7/79/GOB_on_segway.jpg",
    "roles": ["student"],
    "email": "gob.bluth@example.com",
    "phone": "12345556789",
    "locale": "en",
    "time_zone": "America/Los_Angeles",
    "graduation_year": 1996,
    "grade_levels": ["PS"],
    "demographics": {},
    "address": {},
    "properties": {},
    "district_id": "00000000-0000-0000-0000-000000000000",
    "school_ids": ["00000000-0000-0000-0000-000000000000"],
    "department_ids": ["00000000-0000-0000-0000-000000000000"],
    "route_ids": ["00000000-0000-0000-0000-000000000000"]
}

Supported Providers

ProviderSupport