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 Match
POST - https://rest.triand.com/Access/studentMatch
Required Parameters: (JSON)
| Parameter | Business Rule / Regex | Description |
|---|---|---|
| first | /w+/ | Student first name |
| middle | /w*/ | Student middle name (can be empty) |
| last | /w+/ | Student last name |
| ssn | /d{9}/ | Student SSN |
| dob | /d{8}/ | Student Date of Birth (YYYYMMDD) |
| addr1 | /w+/ | Student Address1 (123 Main St) |
| addr2 | /w*/ | Student Address2 (Apt 40) |
| city | /w+/ | Student City |
| state | /w{2}/ | Student State (AR) |
| zip | /w{5}/ | Student Zip |
CURL Example:
curl -X POST https://rest.triand.com/Access/studentMatch
-H "Authorization: Bearer eyJ....really long string...ItCJA"
-H "Accept: application/json"
-H "Content-Type: application/json"
-d '{
"profile": {
"first": "John",
"last": "Doe",
"middle": "A",
"ssn": "123456789",
"dob": "YYYYMMDD",
"addr1": "123 Main St",
"addr2": "Apt 4B",
"city": "Little Rock",
"state": "AR",
"zip": "72201",
}
}'
Javascript fetch Example:
let url = 'https://rest.triand.com/Access/studentMatch';
let parameters = {
profile: {
first: "John",
last: "Doe",
middle: "A",
ssn: "123456789",
dob: "YYYYMMDD",
addr1: "123 Main St",
addr2: "Apt 4B",
city: "Little Rock",
state: "AR",
zip: "72201",
}
}
let opts = {
method: 'POST',
headers: {
'Authorization' = 'Bearer eyJ....really long string...ItCJA'
'Accept': 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify(parameters),
withCredentials: false,
credentials: 'include',
}
let response = await fetch(url, opts); JSON Response
A sample response is listed below.
There are two response fields that are important to note:
- matchId - If this is set, it indicates a successful match was found. Definitely use this as the student State-ID.
- searchIds - When values are present, it indicates potential matches that were found using a loose search.
The stateids above are keys into the students hash in the response.
Each student object contains the following fields:
- reason - A description of why the student was matched (probabilistic-match, or simple-search).
- stateid - The State-ID of the student.
- firstName - The first name of the student.
- lastName - The last name of the student.
- middleName - The middle name of the student.
- uiSearch - Catalog information related to the student.
- guardians - An array of guardian objects, each containing contact information.
- securityQuestions - An array of security questions that can be used for verification.
{ "params": {
"actionOk": true,
"error": [],
"profile": {
"first": "John",
"last": "Doe",
"middle": "A",
"ssn": "123456789",
"dob": "YYYYMMDD",
"addr1": "123 Main St.",
"addr2": "",
"city": "Little Rock",
"state": "AR",
"zip": "72201"
},
"matchId": "4423303018",
"searchIds": ["4405114226"],
"students": {
"4423303018": {
"reason": "probabilistic-match",
"stateid": "4423303018",
"firstName": "John",
"lastName": "Doe",
"middleName": "A",
"uiSearch": {
"localId": "11101",
"stateId": "4423303018",
"nationalId": "4423303018",
"grade": "07",
"dob": "20060713",
"ssn": "xxx-xx-2568",
"authCode": "",
"usState": "AR",
"district": {
"name": "VAN BUREN SCHOOL DISTRICT",
"lea": "1705000",
"pk": 3945
},
"school": {
"name": "NORTHRIDGE MIDDLE SCHOOL",
"lea": "1705033",
"pk": 11559
},
"building": {
"name": "",
"number": ""
},
"enrolled": false,
"enrolledDate": "20190814",
"graduated": false,
"graduatedDate": "",
"userPk": 5739544,
"withdrawalDate": "20190814",
"priorids": []
},
"guardians": [
{
"relationship": "Guardian",
"guardianName": "Allred, Patrick",
"address": "2216 Pauls Valley, Alma, AR 72921",
"lastName": "Allred",
"firstName": "Patrick",
"contactPriority": "1",
"addr1": "2216 Pauls Valley",
"city": "Alma",
"usState": "AR",
"zip": "72921",
"phoneContacts": []
},
{
"relationship": "Guardian",
"guardianName": "Allred, Amy",
"address": "2216 Pauls Valley, Alma, AR 72921",
"lastName": "Allred",
"firstName": "Amy",
"contactPriority": "2",
"addr1": "2216 Pauls Valley",
"city": "Alma",
"usState": "AR",
"zip": "72921",
"phoneContacts": []
}
],
"securityQuestions": [
{
"question": "What is the first name of one of your parents or guardians?",
"correctAnswer": ["Patrick","Amy"],
"wrongAnswers": [
["Crystal"],
["Harley"],
["Chelsey","Blaike"]
]
},
{
"question": "What is a prior (or current) street address of one of your parents or guardians?",
"correctAnswer": "2216 Pauls Valley, Alma, AR 72921",
"wrongAnswers": [
"229 Locust St, Alma, AR 72921",
"1024 Rickey Cir, Van Buren, AR 72956",
"313 S 41 St, Van Buren, AR 72956"
]
}
]
},
"4405114226": {
"reason": "simple-search",
"stateid": "4405114226",
"score": 28.632027,
"firstName": "John",
"lastName": "Doe",
"middleName": "",
"uiSearch": {
"localId": "400003395",
"stateId": "4405114226",
"nationalId": "4405114226",
"grade": "03",
"dob": "20060713",
"ssn": "xxx-xx-1268",
"authCode": "",
"usState": "AR",
"district": {
"name": "ALMA SCHOOL DISTRICT",
"lea": "1701000",
"pk": 3961
},
"school": {
"name": "ALMA INTERMEDIATE SCHOOL",
"lea": "1701001",
"pk": 11217
},
"building": {
"name": "",
"number": ""
},
"enrolled": false,
"enrolledDate": "20150817",
"graduated": false,
"graduatedDate": "",
"userPk": 2038016,
"withdrawalDate": "20150817",
"priorids": []
},
"guardians": [
{
"relationship": "Guardian",
"guardianName": "Allred, Amy",
"address": " 6412 Ridgeway Lane, Alma, AR 72921",
"phone": "4794308745",
"lastName": "Allred",
"firstName": "Amy",
"addr1": "6412 Ridgeway Lane",
"city": "Alma",
"usState": "AR",
"zip": "72921",
"phoneContacts": []
}
],
"securityQuestions": [
{
"question": "What is the first name of one of your parents or guardians?",
"correctAnswer": [ "Amy"],
"wrongAnswers": [
[ "Michelle", "Ian" ],
[ "Natasha", "Jeremy"],
[ "Vanessa", "Donald"]
]
},
{
"question": "What is a prior (or current) street address of one of your parents or guardians?",
"correctAnswer": "6412 Ridgeway Lane, Alma, AR 72921",
"wrongAnswers": [
"507 Riley Dr, Alma, AR 72921",
"8920 Mote Rd, Mountainburg, AR 72946",
"6501 Belmont Dr, Alma, AR 72921"
]
}
]
}
}
},
"timing": {
"srvStart": "2025-07-03 01:40:04.990",
"srvEnd": "2025-07-03 01:40:06.855",
"srvMills": 1865
},
"jwt": "eyJ....really long string...ItCJA",
"frtTkn": "eyJ....really long string...ItCJA"
}}