ACCESS API

Account Management

Account Owners

Arkansas Civics Test

Community Service Learning

Data Services Agreements

Online Testing

Private Schools

Home Schools

Smart Core

Student Transcripts

Advanced Searching

OneRoster API

Student Data API


POST /v1/staff — Search Staff Catalog


Search the staff catalog for teachers, administrators, and other school personnel within your authorized scope.

Request

POST https://api.triand.com/v1/staff
Content-Type: application/json
x-api-key: {your-api-key}
Authorization: Bearer {your-pjwt-token}

Parameters

ParameterBusiness Rule / RegexDescription
limitnumber, 1-100Maximum number of staff records to return (default: 25)
qstringSearch query — supports plain text and advanced field:value syntax
districtleastringDistrict LEA code to search within
schoolleasstring[]Array of school LEA codes to filter by

Advanced Search Syntax

The q parameter supports advanced field:value queries:

SyntaxExampleDescription
last:valuelast:smithSearch by last name
first:valuefirst:janeSearch by first name
district:valuedistrict:dewittSearch by district name
school:valueschool:highSearch by school name
email:valueemail:@dewittSearch by email
plain textjohn smithFull-text search across all fields

You can combine multiple field queries: last:smith district:dewitt

Example Request

{
  "limit": 20,
  "q": "last:smith",
  "districtlea": "1503000"
}

Response

Returns staff records with contact information, school/district assignments, and employment status.

{
  "actionOk": true,
  "error": [],
  "total": 2,
  "records": [67890, 67891],
  "employees": {
    "67890": {
      "firstName": "Jane",
      "lastName": "Smith",
      "email": "jsmith@dewitt.k12.ar.us",
      "stateId": "T1234567",
      "isCurrentEmployee": true,
      "schoolPk": 987
    }
  },
  "users": { ... },
  "avatars": { ... }
}