curl --request GET \
--url https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation \
--header 'x-api-key: <api-key>'import requests
url = "https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Evaluation retrieved",
"meta": {},
"data": {
"id": "6712abcdef123456abcdef01",
"externalId": "applicant-9876",
"status": "completed",
"caseNumber": 10482,
"credentials": [
{
"credentialId": "6712abcdef123456abcdef02",
"uploadId": "6712abcdef123456abcdef03",
"candidate": {
"fullName": "Asha Rao",
"dateOfBirth": "05/14/1998"
},
"institution": {
"name": "Anna University",
"country": "India"
},
"qualification": {
"name": "Bachelor of Technology",
"educationLevel": "BACHELORS",
"program": "Computer Science and Engineering",
"programDurationYears": 4,
"yearOfAdmission": 2016,
"yearsOfAttendance": [
2016,
2017,
2018,
2019,
2020
],
"dateOfAward": "06/30/2020"
},
"evaluations": [
{
"evaluationId": "6712abcdef123456abcdef04",
"status": "completed",
"completedAt": "2026-09-14T11:22:05.000Z",
"targetInstitute": null,
"equivalency": {
"usEquivalency": "Bachelor of Science",
"statement": "Equivalent to a Bachelor of Science in the United States.",
"fieldOfStudy": "Computer Science",
"evaluatedAs": "Bachelor of Technology",
"gpa": {
"weighted": "3.42",
"unweighted": "3.50"
},
"totalCredits": 120,
"creditUnit": "Semester Credits",
"disclaimer": null
},
"courses": [
{
"courseId": "c1",
"courseName": "Data Structures",
"grade": "A",
"point": 4,
"credit": 3,
"isRetaken": false,
"isNonGradable": false,
"isExcluded": false
}
],
"note": "Evaluator note"
}
]
}
]
}
}{
"statusCode": 123,
"message": "<string>"
}{
"statusCode": 123,
"message": "<string>"
}{
"statusCode": 123,
"message": "<string>"
}{
"statusCode": 123,
"message": "<string>"
}Get evaluation results
Returns self-contained candidate, institution, qualification, and evaluated output per credential and target. Evaluation is run by an operator in the UI; this request does not initiate evaluation or require evaluation in upload features. Send at most one of uploadId or credentialId, or omit both for the whole case. Unfinished JSON requests return 200 with progress. Poll this endpoint as a fallback for the best-effort case.evaluation.completed webhook.
curl --request GET \
--url https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation \
--header 'x-api-key: <api-key>'import requests
url = "https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://eval-api.trential.dev/partner/v1/cases/{id}/evaluation")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Evaluation retrieved",
"meta": {},
"data": {
"id": "6712abcdef123456abcdef01",
"externalId": "applicant-9876",
"status": "completed",
"caseNumber": 10482,
"credentials": [
{
"credentialId": "6712abcdef123456abcdef02",
"uploadId": "6712abcdef123456abcdef03",
"candidate": {
"fullName": "Asha Rao",
"dateOfBirth": "05/14/1998"
},
"institution": {
"name": "Anna University",
"country": "India"
},
"qualification": {
"name": "Bachelor of Technology",
"educationLevel": "BACHELORS",
"program": "Computer Science and Engineering",
"programDurationYears": 4,
"yearOfAdmission": 2016,
"yearsOfAttendance": [
2016,
2017,
2018,
2019,
2020
],
"dateOfAward": "06/30/2020"
},
"evaluations": [
{
"evaluationId": "6712abcdef123456abcdef04",
"status": "completed",
"completedAt": "2026-09-14T11:22:05.000Z",
"targetInstitute": null,
"equivalency": {
"usEquivalency": "Bachelor of Science",
"statement": "Equivalent to a Bachelor of Science in the United States.",
"fieldOfStudy": "Computer Science",
"evaluatedAs": "Bachelor of Technology",
"gpa": {
"weighted": "3.42",
"unweighted": "3.50"
},
"totalCredits": 120,
"creditUnit": "Semester Credits",
"disclaimer": null
},
"courses": [
{
"courseId": "c1",
"courseName": "Data Structures",
"grade": "A",
"point": 4,
"credit": 3,
"isRetaken": false,
"isNonGradable": false,
"isExcluded": false
}
],
"note": "Evaluator note"
}
]
}
]
}
}{
"statusCode": 123,
"message": "<string>"
}{
"statusCode": 123,
"message": "<string>"
}{
"statusCode": 123,
"message": "<string>"
}{
"statusCode": 123,
"message": "<string>"
}Authorizations
Partner API key. Also accepted as Authorization: Bearer <key>.
Path Parameters
Identifies the case: its TruEnroll case ID, or the case number (the number shown in TruEnroll and printed on reports). Case numbers are unique across all organizations and lookups are scoped to your own.
Query Parameters
Limit results to this upload. Cannot be used with credentialId.
^[a-fA-F0-9]{24}$Limit results to this existing credential. Cannot be used with uploadId.
^[a-fA-F0-9]{24}$Response
Current evaluation results, including progress for unfinished rows.
true
Optional metadata (e.g. pagination). Empty object when not applicable.
Status aggregates the credentials in this response: queued only when nothing has been evaluated; completed when every credential has at least one evaluation and all are completed; processing otherwise. A credential with no evaluation rows counts as still waiting and holds the case at processing.
Show child attributes
Show child attributes