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

Parameter	Business Rule / Regex	Description
limit	number, 1-100	Maximum number of staff records to return (default: 25)
q	string	Search query — supports plain text and advanced field:value syntax
districtlea	string	District LEA code to search within
schoolleas	string[]	Array of school LEA codes to filter by

Advanced Search Syntax

The q parameter supports advanced field:value queries:

Syntax	Example	Description
last:value	last:smith	Search by last name
first:value	first:jane	Search by first name
district:value	district:dewitt	Search by district name
school:value	school:high	Search by school name
email:value	email:@dewitt	Search by email
plain text	john smith	Full-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": { ... }
}