List Evaluations | TutorFlow Agent Platform Docs

GET /v1/platform/evaluations

Returns a paginated list of evaluation requests for the authenticated workspace.

Query Parameters

Parameter	Type	Default	Description
`limit`	`number`	`20`	Items per page (1–100)
`offset`	`number`	`0`	Number of items to skip
`status`	`string`	-	Filter by status: `PENDING`, `PROCESSING`, `COMPLETED`, or `FAILED`
`evaluationType`	`string`	-	Filter by type: `open_ended`, `rubric_short_answer`, or `exact`
`learnerId`	`string`	-	Filter by learner external ID. See Learner Tracking

Example Request

curl "https://api.tutorflow.io/v1/platform/evaluations?limit=10&offset=0&status=COMPLETED" \
  -H "Authorization: Bearer tf_platform_..."

Response Fields

Field	Type	Description
`items`	`array`	Array of evaluation objects
`total`	`number`	Total number of matching records

Each item in items follows the same schema as the Create Evaluation response.

Response

{
  "items": [
    {
      "id": "2f4ad455-1e8e-4b6c-9f3a-7ebf4cf6f483",
      "status": "COMPLETED",
      "evaluationType": "open_ended",
      "tier": "advanced",
      "score": 8,
      "maxScore": 10,
      "normalizedScore": 80,
      "createdAt": "2026-03-19T10:30:00Z",
      "completedAt": "2026-03-19T10:30:01Z"
    }
  ],
  "total": 1
}