GET /v1/platform/tests
Returns a paginated list of test requests created by the authenticated workspace, ordered by creation time (most recent first).
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status: PENDING, PROCESSING, COMPLETED, or FAILED |
limit | number | No | Maximum number of items to return (default: 20, max: 100) |
offset | number | No | Number of items to skip for pagination (default: 0) |
Example Request
curl "https://api.tutorflow.io/v1/platform/tests?status=COMPLETED&limit=10" \
-H "Authorization: Bearer tf_platform_..."Response
| Field | Type | Description |
|---|---|---|
items | array | Array of test request summaries |
total | number | Total number of test requests matching the filter |
Each item in items is a list summary. It includes request/result identifiers,
status, title, description, level, time limit, total score, item count, share and
public URLs, terminal state, and timestamps. It does not include the generated
items[] array, priceSnapshot, idempotency fields, or polling hints. Call
GET /v1/platform/tests/:id for the full request response.
Example Response
{
"items": [
{
"id": "a1c2d3e4-f5a6-4789-8b0c-d1e2f3a4b5c6",
"status": "COMPLETED",
"classroomTestId": "c7d8e9f0-1a2b-43c4-9e6f-7a8b9c0d1e2f",
"title": "Basic Algebra Quiz",
"description": "A 10-question quiz covering linear equations and inequalities.",
"level": "medium",
"timeLimit": 30,
"totalScore": 100,
"itemCount": 10,
"tier": "default",
"shareToken": "b018172542f9a3c4d5e6f7890abcdef12345678",
"previewUrl": "https://tutorflow.io/en/platform/tests/b018172542f9a3c4d5e6f7890abcdef12345678",
"publicUrl": "https://tutorflow.io/en/platform/tests/take/b018172542f9a3c4d5e6f7890abcdef12345678",
"isTerminal": true,
"createdAt": "2026-03-24T10:32:15.108Z",
"completedAt": "2026-03-24T10:32:31.554Z"
}
],
"total": 1
}