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/students — Search Students


Search for students within your authorized districts and schools. Returns student records along with related school, district, and avatar data.

POST https://api.triand.com/v1/students
Content-Type: application/json
x-api-key: {your-api-key}
Authorization: Bearer {your-pjwt-token}
{
  "limit": 25,
  "districtlea": "1503000",
  "schoolleas": ["1503017"],
  "grades": ["09", "10"],
  "keywords": "smith"
}
FieldTypeDescription
actionOkbooleantrue if the request succeeded
errorstring[]Array of error codes (empty on success)
totalnumberTotal number of matching students
studentsobjectKeyed by student PK — contains name, DOB, grade, stateId, enrollment info
schoolsobjectKeyed by school PK — name, LEA, address
districtsobjectKeyed by district PK — name, LEA
avatarsobjectKeyed by user PK — avatar URL
{
  "actionOk": true,
  "error": [],
  "total": 3,
  "students": {
    "12345": {
      "firstName": "John",
      "lastName": "Smith",
      "stateId": "1234567890",
      "grade": "10",
      "dob": "2010-05-15",
      "schoolPk": 987,
      "districtPk": 45,
      "enrollmentStatus": "active"
    }
  },
  "schools": {
    "987": { "name": "DeWitt High School", "lea": "1503017" }
  },
  "districts": {
    "45": { "name": "DeWitt School District", "lea": "1503000" }
  },
  "avatars": {
    "67890": "default-avatar.gif"
  }
}
  • You can only search within districts/schools authorized in your PJWT token
  • Requests for unauthorized districts return a no-districtlea error
  • Responses larger than 20MB are uploaded to S3 and a signed URL is returned (302 redirect)
  • The keywords parameter searches across name, state ID, and other indexed fields