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
`page`	`number`	`1`	Page number
`take`	`number`	`20`	Items per page (max 100)
`status`	`string`	-	Filter by status: `PENDING`, `PROCESSING`, `COMPLETED`, or `FAILED`
`evaluationType`	`string`	-	Filter by type: `open_ended`, `rubric_short_answer`, or `exact`

Example Request

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

Response

{
  "data": [
    {
      "id": "2f4ad455-1e8e-4b6c-9f3a-7ebf4cf6f483",
      "status": "COMPLETED",
      "evaluationType": "open_ended",
      "tier": "advanced",
      "score": 8,
      "maxScore": 10,
      "normalizedScore": 0.8,
      "createdAt": "2026-03-19T10:30:00Z",
      "completedAt": "2026-03-19T10:30:01Z"
    }
  ],
  "meta": {
    "page": 1,
    "take": 10,
    "itemCount": 1,
    "pageCount": 1,
    "hasPreviousPage": false,
    "hasNextPage": false
  }
}

Each item in data follows the same schema as the Get Evaluation response.