---
title: "Get a staff member by email address"
method: GET
path: "/StaffMember"
tags: ["Staffmember"]
---

# Get a staff member by email address

`GET /StaffMember`

**Requires permission:** *StaffMember*

Get a staff member by email address with optional pagination, sorting, filtering and includes<br />Supported Includes: `LeaveRequests`, `LineManager`, `DirectReports`, `Classes`, `ParentContact` (Also supports includes on the parent contact e.g. `ParentContact.InverseRelations`)

## Query parameters

- `emailAddress` string, nullable
- `page` integer, required
- `pageSize` integer, required
- `includes` string[], nullable
- `sort` string, nullable
- `filter` string, nullable

## Response `200`

Success - Success

- GetStaffMemberResponse
  - `staffMember` StaffMember
    - `staffId` string, guid
    - `employeeId` string, nullable
    - `misId` string, nullable
    - `externalId` string, nullable
    - `externalId2` string, nullable
    - `hrId` string, nullable
    - `payrollId` string, nullable
    - `upi` string, guid, nullable
    - `code` string, nullable
    - `inUse` boolean
    - `email` string, nullable
    - `staffType` string, nullable
    - `school` string, nullable
    - `gender` string, nullable
    - `pronouns` string, nullable
    - `startDate` string, date-time, nullable
    - `leaveDate` string, date-time, nullable
    - `dateOfBirth` string, date-time, nullable
    - `initials` string, nullable
    - `title` string, nullable
    - `forename` string, nullable
    - `preferredName` string, nullable
    - `middleNames` string, nullable
    - `surname` string, nullable
    - `jobTitle` string, nullable
    - `mobileNumber` string, nullable
    - `internalNumber` string, nullable
    - `schoolNumber` string, nullable
    - `addressId` integer, nullable
    - `addressLine1` string, nullable
    - `addressLine2` string, nullable
    - `locality` string, nullable
    - `administrativeArea` string, nullable
    - `country` string, nullable
    - `postcode` string, nullable
    - `lastUpdated` string, date-time, nullable
    - `updatedBy` string, nullable
    - `appAccess` boolean
    - `photo` string, nullable
    - `canBeMasqueraded` boolean
    - `classes` Class[], nullable
      - `classId` string, guid
      - `academicYearId` string, guid
      - `inUse` boolean
      - `misId` string, nullable
      - `code` string, nullable
      - `name` string, nullable
      - `subjectId` string, guid, nullable
      - `subject` string, nullable
      - `room` string, nullable
      - `yearGroup` string, nullable
      - `lastUpdated` string, date-time, nullable
      - `updatedBy` string, nullable
      - `classStaff` ClassStaff[], nullable
        - `classStaffId` string, guid
        - `classId` string, guid
        - `staffUPI` string, guid, nullable
        - `reportWriter` boolean
        - `parentsEvening` boolean
        - `staff` StaffMember — recursive
        - `class` Class — recursive
      - `students` ClassStudent[], nullable
        - `classStudentId` string, guid
        - `classId` string, guid
        - `studentUPI` string, guid, nullable
        - `student` Student
          - `studentId` string, guid
          - `academicYearId` string, guid
          - `misId` string, nullable
          - `externalId` string, nullable
          - `externalId2` string, nullable
          - `upi` string, guid, nullable
          - `upn` string, nullable
          - `code` string, nullable
          - `inUse` boolean
          - `email` string, nullable
          - `academicHouseId` string, guid, nullable
          - `boardingHouseId` string, guid, nullable
          - `yearGroup` string, nullable
          - `form` string, nullable
          - `pupilType` string, nullable
          - `startDate` string, date-time, nullable
          - `leaveDate` string, date-time, nullable
          - `dateOfBirth` string, date-time, nullable
          - `initials` string, nullable
          - `forename` string, nullable
          - `preferredName` string, nullable
          - `middleNames` string, nullable
          - `surname` string, nullable
          - `gender` string, nullable
          - `pronouns` string, nullable
          - `addressId` integer, nullable
          - `addressLine1` string, nullable
          - `addressLine2` string, nullable
          - `locality` string, nullable
          - `administrativeArea` string, nullable
          - `country` string, nullable
          - `postcode` string, nullable
          - `mobileNumber` string, nullable
          - `daytimeNumber` string, nullable
          - `eveningNumber` string, nullable
          - `nationality` string, nullable
          - `secondNationality` string, nullable
          - `lastUpdated` string, date-time, nullable
          - `updatedBy` string, nullable
          - `appAccess` boolean
          - `candidateNumber` integer, nullable
          - `nationalityDescription` string, nullable
          - `yearJoined` integer, nullable
          - `previousSchoolId` string, guid, nullable
          - `attendanceEntries` AttendanceEntry[], nullable
            - `attendanceEntryId` string, guid, nullable
            - `studentUpi` string, guid, nullable
            - `studentName` string, nullable
            - `student` Student — recursive
            - `lessonId` string, guid, nullable
            - `lesson` Lesson
              - …
            - `date` string, date-time
            - `attendanceCode` string, nullable
            - `submitted` string, date-time, nullable
            - `staffName` string, nullable
            - `staffUpi` string, guid, nullable
            - `staff` StaffMember — recursive
            - `archived` boolean
            - `periodId` string, guid, nullable
            - `periodNumber` integer, nullable
            - `period` Period
              - …
            - `classId` string, guid, nullable
            - `classCode` string, nullable
            - `class` Class — recursive
            - `subjectId` string, guid, nullable
            - `subjectCode` string, nullable
            - `subject` Subject
              - …
            - `houseId` string, guid, nullable
            - `house` House
              - …
            - `houseCode` string, nullable
            - `notes` string, nullable
            - `futureAbsenceId` string, guid, nullable
            - `absentAlertCounted` boolean
            - `attendanceCodeObject` AttendanceCode
              - …
            - `isAm` boolean
            - `isPm` boolean
            - `isRegistrationPeriod` boolean
          - `photo` string, nullable
          - `canBeMasqueraded` boolean
          - `sendRecord` Sql02SendRecord
            - `id` integer
            - `sendId` integer
            - `pupil_Name_Id` integer
            - `deleted` boolean, nullable
            - `priority` integer, nullable
            - `laptopUser` boolean, nullable
            - `access` string, nullable
            - `need` string, nullable
            - `youNeedTo` string, nullable
            - `mentor` boolean, nullable
            - `regular` boolean, nullable
            - `leadTeacher` string, nullable
            - `targets` string, nullable
          - `ealRecord` Sql02EalRecord
            - `id` integer
            - `ealId` integer
            - `pupil_Name_Id` integer
            - `deleted` boolean, nullable
            - `priority` integer, nullable
            - `access` string, nullable
            - `need` string, nullable
            - `youNeedTo` string, nullable
            - `leadTeacher` string, nullable
            - `listening` string, nullable
            - `reading` string, nullable
            - `writing` string, nullable
            - `speaking` string, nullable
            - `otherLanguages` string, nullable
            - `furtherComments` string, nullable
            - `pupil_Name_Id_String` string, nullable
          - `medicalRecord` MedicalSummary
            - `id` integer
            - `pupilMedicalId` integer
            - `nameId` integer, nullable
            - `medicalCondition` string, nullable
            - `medicalInformation` string, nullable
            - `allergy` string, nullable
            - `allergyInformation` string, nullable
            - `epiPen` string, nullable
            - `epiPenNotes` string, nullable
            - `inhaler` string, nullable
            - `inhalerNotes` string, nullable
          - `academicHouseObject` House
            - `houseId` string, guid
            - `misId` string, nullable
            - `inUse` boolean
            - `code` string, nullable
            - `name` string, nullable
            - `type` string, nullable
            - `day` boolean, nullable
            - `addressLine1` string, nullable
            - `addressLine2` string, nullable
            - `locality` string, nullable
            - `administrativeArea` string, nullable
            - `country` string, nullable
            - `postcode` string, nullable
            - `longLat` string, nullable
            - `whatThreeWords` string, nullable
            - `daytimeNumber` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `staff` HouseStaff[], nullable
              - …
          - `boardingHouseObject` House
            - `houseId` string, guid
            - `misId` string, nullable
            - `inUse` boolean
            - `code` string, nullable
            - `name` string, nullable
            - `type` string, nullable
            - `day` boolean, nullable
            - `addressLine1` string, nullable
            - `addressLine2` string, nullable
            - `locality` string, nullable
            - `administrativeArea` string, nullable
            - `country` string, nullable
            - `postcode` string, nullable
            - `longLat` string, nullable
            - `whatThreeWords` string, nullable
            - `daytimeNumber` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `staff` HouseStaff[], nullable
              - …
          - `formObject` Form
            - `formId` string, guid
            - `academicYearId` string, guid
            - `inUse` boolean
            - `misId` string, nullable
            - `code` string, nullable
            - `name` string, nullable
            - `year` string, nullable
            - `room` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `staff` StaffMember[], nullable
            - `students` Student[], nullable
          - `yearObject` Year
            - `yearId` string, guid
            - `academicYearId` string, guid
            - `misId` string, nullable
            - `code` string, nullable
            - `name` string, nullable
            - `finalYear` boolean
            - `dfEYear` integer, nullable
            - `position` integer, nullable
            - `inUse` boolean
            - `lastUpdated` string, date-time, nullable
            - `students` Student[]
            - `updatedBy` string, nullable
          - `relations` Relationship[], nullable
            - `relationshipId` string, guid
            - `fromUPI` string, guid, nullable
            - `toUPI` string, guid, nullable
            - `relationshipName` string, nullable
            - `rank` integer, nullable
            - `billing` boolean
            - `emergency` boolean
            - `medical` boolean
            - `courtOrder` boolean
            - `restricted` boolean
            - `relationshipType` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `createdByApp` boolean
            - `fromPerson` unknown
            - `toPerson` unknown
          - `inverseRelations` Relationship[], nullable
            - `relationshipId` string, guid
            - `fromUPI` string, guid, nullable
            - `toUPI` string, guid, nullable
            - `relationshipName` string, nullable
            - `rank` integer, nullable
            - `billing` boolean
            - `emergency` boolean
            - `medical` boolean
            - `courtOrder` boolean
            - `restricted` boolean
            - `relationshipType` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `createdByApp` boolean
            - `fromPerson` unknown
            - `toPerson` unknown
          - `classes` Class[], nullable
          - `musicLessons` MusicLesson[], nullable
            - `id` integer
            - `studentNameId` integer
            - `studentUpi` string, guid, nullable
            - `teacherEmail` string, nullable
            - `instrumentId` integer
            - `lessons` integer
            - `created` string, date-time, nullable
            - `edited` string, date-time, nullable
            - `free` boolean, nullable
            - `notes` string, nullable
            - `archived` boolean
            - `instrument` MusicInstrument
              - …
            - `teacher` StaffMember — recursive
            - `student` Student — recursive
            - `scholar` boolean
          - `previousSchool` OtherSchool
            - `otherSchoolId` string, guid
            - `name` string, nullable
            - `addressLine1` string, nullable
            - `addressLine2` string, nullable
            - `locality` string, nullable
            - `administrativeArea` string, nullable
            - `country` string, nullable
            - `postcode` string, nullable
            - `primaryContactName` string, nullable
            - `email` string, nullable
            - `telephone` string, nullable
            - `website` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `code` string, nullable
          - `userFields` UserField[], nullable
            - `userFieldId` string, guid
            - `upi` string, guid, required
            - `displayName` string, nullable
            - `value` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `fromMis` boolean, required
    - `userFields` UserField[], nullable
      - `userFieldId` string, guid
      - `upi` string, guid, required
      - `displayName` string, nullable
      - `value` string, nullable
      - `lastUpdated` string, date-time, nullable
      - `updatedBy` string, nullable
      - `fromMis` boolean, required
  - `microsoftUser` MicrosoftUser
    - `@odata.context` string, nullable
    - `id` string, guid, nullable
    - `accountEnabled` boolean
    - `manager` MicrosoftUser — recursive
    - `businessPhones` string[], nullable
    - `city` string, nullable
    - `createdDateTime` string, date-time
    - `companyName` string, nullable
    - `department` string, nullable
    - `displayName` string, nullable
    - `jobTitle` string, nullable
    - `mail` string, nullable
    - `mailNickname` string, nullable
    - `mobilePhone` string, nullable
    - `onPremisesDistinguishedName` string, nullable
    - `officeLocation` string, nullable
    - `onPremisesDomainName` string, nullable
    - `onPremisesImmutableId` string, nullable
    - `onPremisesLastSyncDateTime` string, date-time
    - `onPremisesSamAccountName` string, nullable
    - `onPremisesSyncEnabled` boolean
    - `onPremisesUserPrincipalName` string, nullable
    - `otherMails` string[], nullable
    - `passwordPolicies` string, nullable
    - `refreshTokensValidFromDateTime` string, date-time
    - `usageLocation` string, nullable
    - `userType` string, nullable
    - `assignedLicenses` AssignedLicense[], nullable
      - `disabledPlans` string[], nullable
      - `skuId` string, nullable
    - `assignedPlans` AssignedPlan[], nullable
      - `assignedDateTime` string, date-time
      - `capabilityStatus` string, nullable
      - `service` string, nullable
      - `servicePlanId` string, nullable
    - `authorizationInfo` AuthorizationInfo
      - `certificateUserIds` unknown[], nullable
        - unknown
    - `deviceKeys` DeviceKey[], nullable
      - `deviceId` string, nullable
      - `keyMaterial` string, nullable
      - `keyType` string, nullable
    - `identities` Identity[], nullable
      - `signInType` string, nullable
      - `issuer` string, nullable
      - `issuerAssignedId` string, nullable
    - `onPremisesExtensionAttributes` OnPremisesExtensionAttributes
      - `extensionAttribute1` string, nullable
      - `extensionAttribute2` string, nullable
      - `extensionAttribute3` string, nullable
      - `extensionAttribute4` string, nullable
      - `extensionAttribute5` string, nullable
      - `extensionAttribute6` string, nullable
      - `extensionAttribute7` string, nullable
      - `extensionAttribute8` string, nullable
      - `extensionAttribute9` string, nullable
      - `extensionAttribute10` string, nullable
      - `extensionAttribute11` string, nullable
      - `extensionAttribute12` string, nullable
      - `extensionAttribute13` string, nullable
      - `extensionAttribute14` string, nullable
      - `extensionAttribute15` string, nullable
    - `onPremisesProvisioningErrors` unknown[], nullable
      - unknown
    - `provisionedPlans` ProvisionedPlan[], nullable
      - `capabilityStatus` string, nullable
      - `provisioningStatus` string, nullable
      - `service` string, nullable
    - `givenName` string, nullable
    - `surname` string, nullable
    - `userPrincipalName` string, nullable
    - `photo` string, nullable
    - `canBeMasqueraded` boolean
  - `leaveRequests` LeaveRequest[], nullable
    - `id` integer
    - `sDateTime` string, date-time
    - `eDateTime` string, date-time
    - `leaveType` string
    - `numOfDays` number, double
    - `description` string, nullable
    - `status` string
    - `managerEmail` string
    - `employeeEmail` string
    - `employeeName` string
    - `department` string
    - `msEvent` string, nullable
  - `lineManager` MicrosoftUser
    - `@odata.context` string, nullable
    - `id` string, guid, nullable
    - `accountEnabled` boolean
    - `manager` MicrosoftUser — recursive
    - `businessPhones` string[], nullable
    - `city` string, nullable
    - `createdDateTime` string, date-time
    - `companyName` string, nullable
    - `department` string, nullable
    - `displayName` string, nullable
    - `jobTitle` string, nullable
    - `mail` string, nullable
    - `mailNickname` string, nullable
    - `mobilePhone` string, nullable
    - `onPremisesDistinguishedName` string, nullable
    - `officeLocation` string, nullable
    - `onPremisesDomainName` string, nullable
    - `onPremisesImmutableId` string, nullable
    - `onPremisesLastSyncDateTime` string, date-time
    - `onPremisesSamAccountName` string, nullable
    - `onPremisesSyncEnabled` boolean
    - `onPremisesUserPrincipalName` string, nullable
    - `otherMails` string[], nullable
    - `passwordPolicies` string, nullable
    - `refreshTokensValidFromDateTime` string, date-time
    - `usageLocation` string, nullable
    - `userType` string, nullable
    - `assignedLicenses` AssignedLicense[], nullable
      - `disabledPlans` string[], nullable
      - `skuId` string, nullable
    - `assignedPlans` AssignedPlan[], nullable
      - `assignedDateTime` string, date-time
      - `capabilityStatus` string, nullable
      - `service` string, nullable
      - `servicePlanId` string, nullable
    - `authorizationInfo` AuthorizationInfo
      - `certificateUserIds` unknown[], nullable
        - unknown
    - `deviceKeys` DeviceKey[], nullable
      - `deviceId` string, nullable
      - `keyMaterial` string, nullable
      - `keyType` string, nullable
    - `identities` Identity[], nullable
      - `signInType` string, nullable
      - `issuer` string, nullable
      - `issuerAssignedId` string, nullable
    - `onPremisesExtensionAttributes` OnPremisesExtensionAttributes
      - `extensionAttribute1` string, nullable
      - `extensionAttribute2` string, nullable
      - `extensionAttribute3` string, nullable
      - `extensionAttribute4` string, nullable
      - `extensionAttribute5` string, nullable
      - `extensionAttribute6` string, nullable
      - `extensionAttribute7` string, nullable
      - `extensionAttribute8` string, nullable
      - `extensionAttribute9` string, nullable
      - `extensionAttribute10` string, nullable
      - `extensionAttribute11` string, nullable
      - `extensionAttribute12` string, nullable
      - `extensionAttribute13` string, nullable
      - `extensionAttribute14` string, nullable
      - `extensionAttribute15` string, nullable
    - `onPremisesProvisioningErrors` unknown[], nullable
      - unknown
    - `provisionedPlans` ProvisionedPlan[], nullable
      - `capabilityStatus` string, nullable
      - `provisioningStatus` string, nullable
      - `service` string, nullable
    - `givenName` string, nullable
    - `surname` string, nullable
    - `userPrincipalName` string, nullable
    - `photo` string, nullable
    - `canBeMasqueraded` boolean
  - `directReports` MicrosoftUser[], nullable
    - `@odata.context` string, nullable
    - `id` string, guid, nullable
    - `accountEnabled` boolean
    - `manager` MicrosoftUser — recursive
    - `businessPhones` string[], nullable
    - `city` string, nullable
    - `createdDateTime` string, date-time
    - `companyName` string, nullable
    - `department` string, nullable
    - `displayName` string, nullable
    - `jobTitle` string, nullable
    - `mail` string, nullable
    - `mailNickname` string, nullable
    - `mobilePhone` string, nullable
    - `onPremisesDistinguishedName` string, nullable
    - `officeLocation` string, nullable
    - `onPremisesDomainName` string, nullable
    - `onPremisesImmutableId` string, nullable
    - `onPremisesLastSyncDateTime` string, date-time
    - `onPremisesSamAccountName` string, nullable
    - `onPremisesSyncEnabled` boolean
    - `onPremisesUserPrincipalName` string, nullable
    - `otherMails` string[], nullable
    - `passwordPolicies` string, nullable
    - `refreshTokensValidFromDateTime` string, date-time
    - `usageLocation` string, nullable
    - `userType` string, nullable
    - `assignedLicenses` AssignedLicense[], nullable
      - `disabledPlans` string[], nullable
      - `skuId` string, nullable
    - `assignedPlans` AssignedPlan[], nullable
      - `assignedDateTime` string, date-time
      - `capabilityStatus` string, nullable
      - `service` string, nullable
      - `servicePlanId` string, nullable
    - `authorizationInfo` AuthorizationInfo
      - `certificateUserIds` unknown[], nullable
        - unknown
    - `deviceKeys` DeviceKey[], nullable
      - `deviceId` string, nullable
      - `keyMaterial` string, nullable
      - `keyType` string, nullable
    - `identities` Identity[], nullable
      - `signInType` string, nullable
      - `issuer` string, nullable
      - `issuerAssignedId` string, nullable
    - `onPremisesExtensionAttributes` OnPremisesExtensionAttributes
      - `extensionAttribute1` string, nullable
      - `extensionAttribute2` string, nullable
      - `extensionAttribute3` string, nullable
      - `extensionAttribute4` string, nullable
      - `extensionAttribute5` string, nullable
      - `extensionAttribute6` string, nullable
      - `extensionAttribute7` string, nullable
      - `extensionAttribute8` string, nullable
      - `extensionAttribute9` string, nullable
      - `extensionAttribute10` string, nullable
      - `extensionAttribute11` string, nullable
      - `extensionAttribute12` string, nullable
      - `extensionAttribute13` string, nullable
      - `extensionAttribute14` string, nullable
      - `extensionAttribute15` string, nullable
    - `onPremisesProvisioningErrors` unknown[], nullable
      - unknown
    - `provisionedPlans` ProvisionedPlan[], nullable
      - `capabilityStatus` string, nullable
      - `provisioningStatus` string, nullable
      - `service` string, nullable
    - `givenName` string, nullable
    - `surname` string, nullable
    - `userPrincipalName` string, nullable
    - `photo` string, nullable
    - `canBeMasqueraded` boolean
  - `classes` Class[], nullable
    - `classId` string, guid
    - `academicYearId` string, guid
    - `inUse` boolean
    - `misId` string, nullable
    - `code` string, nullable
    - `name` string, nullable
    - `subjectId` string, guid, nullable
    - `subject` string, nullable
    - `room` string, nullable
    - `yearGroup` string, nullable
    - `lastUpdated` string, date-time, nullable
    - `updatedBy` string, nullable
    - `classStaff` ClassStaff[], nullable
      - `classStaffId` string, guid
      - `classId` string, guid
      - `staffUPI` string, guid, nullable
      - `reportWriter` boolean
      - `parentsEvening` boolean
      - `staff` StaffMember
        - `staffId` string, guid
        - `employeeId` string, nullable
        - `misId` string, nullable
        - `externalId` string, nullable
        - `externalId2` string, nullable
        - `hrId` string, nullable
        - `payrollId` string, nullable
        - `upi` string, guid, nullable
        - `code` string, nullable
        - `inUse` boolean
        - `email` string, nullable
        - `staffType` string, nullable
        - `school` string, nullable
        - `gender` string, nullable
        - `pronouns` string, nullable
        - `startDate` string, date-time, nullable
        - `leaveDate` string, date-time, nullable
        - `dateOfBirth` string, date-time, nullable
        - `initials` string, nullable
        - `title` string, nullable
        - `forename` string, nullable
        - `preferredName` string, nullable
        - `middleNames` string, nullable
        - `surname` string, nullable
        - `jobTitle` string, nullable
        - `mobileNumber` string, nullable
        - `internalNumber` string, nullable
        - `schoolNumber` string, nullable
        - `addressId` integer, nullable
        - `addressLine1` string, nullable
        - `addressLine2` string, nullable
        - `locality` string, nullable
        - `administrativeArea` string, nullable
        - `country` string, nullable
        - `postcode` string, nullable
        - `lastUpdated` string, date-time, nullable
        - `updatedBy` string, nullable
        - `appAccess` boolean
        - `photo` string, nullable
        - `canBeMasqueraded` boolean
        - `classes` Class[], nullable
        - `userFields` UserField[], nullable
          - `userFieldId` string, guid
          - `upi` string, guid, required
          - `displayName` string, nullable
          - `value` string, nullable
          - `lastUpdated` string, date-time, nullable
          - `updatedBy` string, nullable
          - `fromMis` boolean, required
      - `class` Class — recursive
    - `students` ClassStudent[], nullable
      - `classStudentId` string, guid
      - `classId` string, guid
      - `studentUPI` string, guid, nullable
      - `student` Student
        - `studentId` string, guid
        - `academicYearId` string, guid
        - `misId` string, nullable
        - `externalId` string, nullable
        - `externalId2` string, nullable
        - `upi` string, guid, nullable
        - `upn` string, nullable
        - `code` string, nullable
        - `inUse` boolean
        - `email` string, nullable
        - `academicHouseId` string, guid, nullable
        - `boardingHouseId` string, guid, nullable
        - `yearGroup` string, nullable
        - `form` string, nullable
        - `pupilType` string, nullable
        - `startDate` string, date-time, nullable
        - `leaveDate` string, date-time, nullable
        - `dateOfBirth` string, date-time, nullable
        - `initials` string, nullable
        - `forename` string, nullable
        - `preferredName` string, nullable
        - `middleNames` string, nullable
        - `surname` string, nullable
        - `gender` string, nullable
        - `pronouns` string, nullable
        - `addressId` integer, nullable
        - `addressLine1` string, nullable
        - `addressLine2` string, nullable
        - `locality` string, nullable
        - `administrativeArea` string, nullable
        - `country` string, nullable
        - `postcode` string, nullable
        - `mobileNumber` string, nullable
        - `daytimeNumber` string, nullable
        - `eveningNumber` string, nullable
        - `nationality` string, nullable
        - `secondNationality` string, nullable
        - `lastUpdated` string, date-time, nullable
        - `updatedBy` string, nullable
        - `appAccess` boolean
        - `candidateNumber` integer, nullable
        - `nationalityDescription` string, nullable
        - `yearJoined` integer, nullable
        - `previousSchoolId` string, guid, nullable
        - `attendanceEntries` AttendanceEntry[], nullable
          - `attendanceEntryId` string, guid, nullable
          - `studentUpi` string, guid, nullable
          - `studentName` string, nullable
          - `student` Student — recursive
          - `lessonId` string, guid, nullable
          - `lesson` Lesson
            - `lessonId` string, guid
            - `class` Class — recursive
            - `dayDate` DayDate
              - …
            - `period` Period
              - …
            - `room` Room
              - …
            - `staffUpi` string, guid, nullable
            - `staff` StaffMember
              - …
            - `archived` boolean
          - `date` string, date-time
          - `attendanceCode` string, nullable
          - `submitted` string, date-time, nullable
          - `staffName` string, nullable
          - `staffUpi` string, guid, nullable
          - `staff` StaffMember
            - `staffId` string, guid
            - `employeeId` string, nullable
            - `misId` string, nullable
            - `externalId` string, nullable
            - `externalId2` string, nullable
            - `hrId` string, nullable
            - `payrollId` string, nullable
            - `upi` string, guid, nullable
            - `code` string, nullable
            - `inUse` boolean
            - `email` string, nullable
            - `staffType` string, nullable
            - `school` string, nullable
            - `gender` string, nullable
            - `pronouns` string, nullable
            - `startDate` string, date-time, nullable
            - `leaveDate` string, date-time, nullable
            - `dateOfBirth` string, date-time, nullable
            - `initials` string, nullable
            - `title` string, nullable
            - `forename` string, nullable
            - `preferredName` string, nullable
            - `middleNames` string, nullable
            - `surname` string, nullable
            - `jobTitle` string, nullable
            - `mobileNumber` string, nullable
            - `internalNumber` string, nullable
            - `schoolNumber` string, nullable
            - `addressId` integer, nullable
            - `addressLine1` string, nullable
            - `addressLine2` string, nullable
            - `locality` string, nullable
            - `administrativeArea` string, nullable
            - `country` string, nullable
            - `postcode` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `appAccess` boolean
            - `photo` string, nullable
            - `canBeMasqueraded` boolean
            - `classes` Class[], nullable
            - `userFields` UserField[], nullable
              - …
          - `archived` boolean
          - `periodId` string, guid, nullable
          - `periodNumber` integer, nullable
          - `period` Period
            - `periodId` string, guid
            - `description` string
            - `day` Day
              - …
            - `startTime` string, time, nullable
            - `endTime` string, time, nullable
            - `periodNumber` integer, nullable
            - `session` string
            - `archived` boolean
            - `timetableMisId` string, nullable
            - `timetableId` string, guid, nullable
            - `timetable` Timetable
              - …
            - `class` Class — recursive
            - `lesson` Lesson
              - …
            - `house` House
              - …
            - `attendanceRegistrationPermissions` AttendancePeriodRegistrationPermission[]
              - …
          - `classId` string, guid, nullable
          - `classCode` string, nullable
          - `class` Class — recursive
          - `subjectId` string, guid, nullable
          - `subjectCode` string, nullable
          - `subject` Subject
            - `subjectId` string, guid
            - `misId` string, nullable
            - `code` string, nullable
            - `inUse` boolean, nullable
            - `department` string, nullable
            - `name` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `subjectHeads` SubjectHead[], nullable
              - …
            - `classes` Class[], nullable
          - `houseId` string, guid, nullable
          - `house` House
            - `houseId` string, guid
            - `misId` string, nullable
            - `inUse` boolean
            - `code` string, nullable
            - `name` string, nullable
            - `type` string, nullable
            - `day` boolean, nullable
            - `addressLine1` string, nullable
            - `addressLine2` string, nullable
            - `locality` string, nullable
            - `administrativeArea` string, nullable
            - `country` string, nullable
            - `postcode` string, nullable
            - `longLat` string, nullable
            - `whatThreeWords` string, nullable
            - `daytimeNumber` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `staff` HouseStaff[], nullable
              - …
          - `houseCode` string, nullable
          - `notes` string, nullable
          - `futureAbsenceId` string, guid, nullable
          - `absentAlertCounted` boolean
          - `attendanceCodeObject` AttendanceCode
            - `attendanceCodeId` string, guid, nullable
            - `code` string
            - `description` string
            - `category` string
            - `eventType` string, nullable
            - `session` string, nullable
            - `order` integer, nullable
            - `display` boolean, nullable
            - `archived` boolean
            - `showInAbsenceOffex` boolean
            - `isAbsent` boolean
            - `isPresent` boolean
            - `isLate` boolean
            - `isUnauthorised` boolean
          - `isAm` boolean
          - `isPm` boolean
          - `isRegistrationPeriod` boolean
        - `photo` string, nullable
        - `canBeMasqueraded` boolean
        - `sendRecord` Sql02SendRecord
          - `id` integer
          - `sendId` integer
          - `pupil_Name_Id` integer
          - `deleted` boolean, nullable
          - `priority` integer, nullable
          - `laptopUser` boolean, nullable
          - `access` string, nullable
          - `need` string, nullable
          - `youNeedTo` string, nullable
          - `mentor` boolean, nullable
          - `regular` boolean, nullable
          - `leadTeacher` string, nullable
          - `targets` string, nullable
        - `ealRecord` Sql02EalRecord
          - `id` integer
          - `ealId` integer
          - `pupil_Name_Id` integer
          - `deleted` boolean, nullable
          - `priority` integer, nullable
          - `access` string, nullable
          - `need` string, nullable
          - `youNeedTo` string, nullable
          - `leadTeacher` string, nullable
          - `listening` string, nullable
          - `reading` string, nullable
          - `writing` string, nullable
          - `speaking` string, nullable
          - `otherLanguages` string, nullable
          - `furtherComments` string, nullable
          - `pupil_Name_Id_String` string, nullable
        - `medicalRecord` MedicalSummary
          - `id` integer
          - `pupilMedicalId` integer
          - `nameId` integer, nullable
          - `medicalCondition` string, nullable
          - `medicalInformation` string, nullable
          - `allergy` string, nullable
          - `allergyInformation` string, nullable
          - `epiPen` string, nullable
          - `epiPenNotes` string, nullable
          - `inhaler` string, nullable
          - `inhalerNotes` string, nullable
        - `academicHouseObject` House
          - `houseId` string, guid
          - `misId` string, nullable
          - `inUse` boolean
          - `code` string, nullable
          - `name` string, nullable
          - `type` string, nullable
          - `day` boolean, nullable
          - `addressLine1` string, nullable
          - `addressLine2` string, nullable
          - `locality` string, nullable
          - `administrativeArea` string, nullable
          - `country` string, nullable
          - `postcode` string, nullable
          - `longLat` string, nullable
          - `whatThreeWords` string, nullable
          - `daytimeNumber` string, nullable
          - `lastUpdated` string, date-time, nullable
          - `updatedBy` string, nullable
          - `staff` HouseStaff[], nullable
            - `houseStaffId` string, guid
            - `houseId` string, guid
            - `houseCode` string, nullable
            - `staffUPI` string, guid, nullable
            - `role` string, nullable
            - `phoneNumber` string, nullable
            - `bookableInHouseTours` boolean
            - `updateInSync` boolean
            - `staff` StaffMember
              - …
        - `boardingHouseObject` House
          - `houseId` string, guid
          - `misId` string, nullable
          - `inUse` boolean
          - `code` string, nullable
          - `name` string, nullable
          - `type` string, nullable
          - `day` boolean, nullable
          - `addressLine1` string, nullable
          - `addressLine2` string, nullable
          - `locality` string, nullable
          - `administrativeArea` string, nullable
          - `country` string, nullable
          - `postcode` string, nullable
          - `longLat` string, nullable
          - `whatThreeWords` string, nullable
          - `daytimeNumber` string, nullable
          - `lastUpdated` string, date-time, nullable
          - `updatedBy` string, nullable
          - `staff` HouseStaff[], nullable
            - `houseStaffId` string, guid
            - `houseId` string, guid
            - `houseCode` string, nullable
            - `staffUPI` string, guid, nullable
            - `role` string, nullable
            - `phoneNumber` string, nullable
            - `bookableInHouseTours` boolean
            - `updateInSync` boolean
            - `staff` StaffMember
              - …
        - `formObject` Form
          - `formId` string, guid
          - `academicYearId` string, guid
          - `inUse` boolean
          - `misId` string, nullable
          - `code` string, nullable
          - `name` string, nullable
          - `year` string, nullable
          - `room` string, nullable
          - `lastUpdated` string, date-time, nullable
          - `updatedBy` string, nullable
          - `staff` StaffMember[], nullable
            - `staffId` string, guid
            - `employeeId` string, nullable
            - `misId` string, nullable
            - `externalId` string, nullable
            - `externalId2` string, nullable
            - `hrId` string, nullable
            - `payrollId` string, nullable
            - `upi` string, guid, nullable
            - `code` string, nullable
            - `inUse` boolean
            - `email` string, nullable
            - `staffType` string, nullable
            - `school` string, nullable
            - `gender` string, nullable
            - `pronouns` string, nullable
            - `startDate` string, date-time, nullable
            - `leaveDate` string, date-time, nullable
            - `dateOfBirth` string, date-time, nullable
            - `initials` string, nullable
            - `title` string, nullable
            - `forename` string, nullable
            - `preferredName` string, nullable
            - `middleNames` string, nullable
            - `surname` string, nullable
            - `jobTitle` string, nullable
            - `mobileNumber` string, nullable
            - `internalNumber` string, nullable
            - `schoolNumber` string, nullable
            - `addressId` integer, nullable
            - `addressLine1` string, nullable
            - `addressLine2` string, nullable
            - `locality` string, nullable
            - `administrativeArea` string, nullable
            - `country` string, nullable
            - `postcode` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `appAccess` boolean
            - `photo` string, nullable
            - `canBeMasqueraded` boolean
            - `classes` Class[], nullable
            - `userFields` UserField[], nullable
              - …
          - `students` Student[], nullable
        - `yearObject` Year
          - `yearId` string, guid
          - `academicYearId` string, guid
          - `misId` string, nullable
          - `code` string, nullable
          - `name` string, nullable
          - `finalYear` boolean
          - `dfEYear` integer, nullable
          - `position` integer, nullable
          - `inUse` boolean
          - `lastUpdated` string, date-time, nullable
          - `students` Student[]
          - `updatedBy` string, nullable
        - `relations` Relationship[], nullable
          - `relationshipId` string, guid
          - `fromUPI` string, guid, nullable
          - `toUPI` string, guid, nullable
          - `relationshipName` string, nullable
          - `rank` integer, nullable
          - `billing` boolean
          - `emergency` boolean
          - `medical` boolean
          - `courtOrder` boolean
          - `restricted` boolean
          - `relationshipType` string, nullable
          - `lastUpdated` string, date-time, nullable
          - `updatedBy` string, nullable
          - `createdByApp` boolean
          - `fromPerson` unknown
          - `toPerson` unknown
        - `inverseRelations` Relationship[], nullable
          - `relationshipId` string, guid
          - `fromUPI` string, guid, nullable
          - `toUPI` string, guid, nullable
          - `relationshipName` string, nullable
          - `rank` integer, nullable
          - `billing` boolean
          - `emergency` boolean
          - `medical` boolean
          - `courtOrder` boolean
          - `restricted` boolean
          - `relationshipType` string, nullable
          - `lastUpdated` string, date-time, nullable
          - `updatedBy` string, nullable
          - `createdByApp` boolean
          - `fromPerson` unknown
          - `toPerson` unknown
        - `classes` Class[], nullable
        - `musicLessons` MusicLesson[], nullable
          - `id` integer
          - `studentNameId` integer
          - `studentUpi` string, guid, nullable
          - `teacherEmail` string, nullable
          - `instrumentId` integer
          - `lessons` integer
          - `created` string, date-time, nullable
          - `edited` string, date-time, nullable
          - `free` boolean, nullable
          - `notes` string, nullable
          - `archived` boolean
          - `instrument` MusicInstrument
            - `id` integer
            - `description` string, nullable
            - `archived` boolean
            - `orchestralOrder` integer
          - `teacher` StaffMember
            - `staffId` string, guid
            - `employeeId` string, nullable
            - `misId` string, nullable
            - `externalId` string, nullable
            - `externalId2` string, nullable
            - `hrId` string, nullable
            - `payrollId` string, nullable
            - `upi` string, guid, nullable
            - `code` string, nullable
            - `inUse` boolean
            - `email` string, nullable
            - `staffType` string, nullable
            - `school` string, nullable
            - `gender` string, nullable
            - `pronouns` string, nullable
            - `startDate` string, date-time, nullable
            - `leaveDate` string, date-time, nullable
            - `dateOfBirth` string, date-time, nullable
            - `initials` string, nullable
            - `title` string, nullable
            - `forename` string, nullable
            - `preferredName` string, nullable
            - `middleNames` string, nullable
            - `surname` string, nullable
            - `jobTitle` string, nullable
            - `mobileNumber` string, nullable
            - `internalNumber` string, nullable
            - `schoolNumber` string, nullable
            - `addressId` integer, nullable
            - `addressLine1` string, nullable
            - `addressLine2` string, nullable
            - `locality` string, nullable
            - `administrativeArea` string, nullable
            - `country` string, nullable
            - `postcode` string, nullable
            - `lastUpdated` string, date-time, nullable
            - `updatedBy` string, nullable
            - `appAccess` boolean
            - `photo` string, nullable
            - `canBeMasqueraded` boolean
            - `classes` Class[], nullable
            - `userFields` UserField[], nullable
              - …
          - `student` Student — recursive
          - `scholar` boolean
        - `previousSchool` OtherSchool
          - `otherSchoolId` string, guid
          - `name` string, nullable
          - `addressLine1` string, nullable
          - `addressLine2` string, nullable
          - `locality` string, nullable
          - `administrativeArea` string, nullable
          - `country` string, nullable
          - `postcode` string, nullable
          - `primaryContactName` string, nullable
          - `email` string, nullable
          - `telephone` string, nullable
          - `website` string, nullable
          - `lastUpdated` string, date-time, nullable
          - `updatedBy` string, nullable
          - `code` string, nullable
        - `userFields` UserField[], nullable
          - `userFieldId` string, guid
          - `upi` string, guid, required
          - `displayName` string, nullable
          - `value` string, nullable
          - `lastUpdated` string, date-time, nullable
          - `updatedBy` string, nullable
          - `fromMis` boolean, required
  - `parentContact` Contact
    - `contactId` string, guid
    - `misId` string, nullable
    - `externalId` string, nullable
    - `feeId` string, nullable
    - `upi` string, guid, nullable
    - `inUse` boolean
    - `email` string, nullable
    - `dateOfBirth` string, date-time, nullable
    - `occupation` string, nullable
    - `initials` string, nullable
    - `title` string, nullable
    - `forename` string, nullable
    - `preferredName` string, nullable
    - `middleNames` string, nullable
    - `surname` string, nullable
    - `gender` string, nullable
    - `pronouns` string, nullable
    - `addressId` integer, nullable
    - `addressLine1` string, nullable
    - `addressLine2` string, nullable
    - `locality` string, nullable
    - `administrativeArea` string, nullable
    - `country` string, nullable
    - `postcode` string, nullable
    - `mobileNumber` string, nullable
    - `daytimeNumber` string, nullable
    - `eveningNumber` string, nullable
    - `lastUpdated` string, date-time, nullable
    - `updatedBy` string, nullable
    - `appAccess` boolean
    - `letterSalutation` string, nullable
    - `labelSalutation` string, nullable
    - `flag` string, nullable
    - `deceased` boolean
    - `photo` string, nullable
    - `canBeMasqueraded` boolean
    - `relations` Relationship[], nullable
      - `relationshipId` string, guid
      - `fromUPI` string, guid, nullable
      - `toUPI` string, guid, nullable
      - `relationshipName` string, nullable
      - `rank` integer, nullable
      - `billing` boolean
      - `emergency` boolean
      - `medical` boolean
      - `courtOrder` boolean
      - `restricted` boolean
      - `relationshipType` string, nullable
      - `lastUpdated` string, date-time, nullable
      - `updatedBy` string, nullable
      - `createdByApp` boolean
      - `fromPerson` unknown
      - `toPerson` unknown
    - `inverseRelations` Relationship[], nullable
      - `relationshipId` string, guid
      - `fromUPI` string, guid, nullable
      - `toUPI` string, guid, nullable
      - `relationshipName` string, nullable
      - `rank` integer, nullable
      - `billing` boolean
      - `emergency` boolean
      - `medical` boolean
      - `courtOrder` boolean
      - `restricted` boolean
      - `relationshipType` string, nullable
      - `lastUpdated` string, date-time, nullable
      - `updatedBy` string, nullable
      - `createdByApp` boolean
      - `fromPerson` unknown
      - `toPerson` unknown
    - `userFields` UserField[], nullable
      - `userFieldId` string, guid
      - `upi` string, guid, required
      - `displayName` string, nullable
      - `value` string, nullable
      - `lastUpdated` string, date-time, nullable
      - `updatedBy` string, nullable
      - `fromMis` boolean, required
    - `relationshipType` string, nullable
    - `relationshipName` string, nullable
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `400` — An Error Occurred - Explain Error
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/versions/fab57bf5558a/schema)
