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 (same shape as the GET /:id response) |
total | number | Total number of test requests matching the filter |
limit | number | Limit applied to this response |
offset | number | Offset applied to this response |
Each item in items follows the TestResDto shape — see Create Test
for the full field list.
Example Response
{
"items": [
{
"id": "a1c2d3e4-f5g6-7h8i-9j0k-l1m2n3o4p5q6",
"status": "COMPLETED",
"classroomTestId": "c7d8e9f0-1a2b-3c4d-5e6f-7g8h9i0j1k2l",
"title": "Basic Algebra Quiz",
"description": "A 10-question quiz covering linear equations and inequalities.",
"level": "medium",
"timeLimit": 30,
"totalScore": 100,
"itemCount": 10,
"tier": "standard",
"priceSnapshot": {
"category": "test_creation",
"catalogKey": "test_creation.standard",
"tier": "standard",
"amountUsd": 0.15,
"unit": "test",
"currency": "USD",
"source": "platform_pricing_catalog_v1"
},
"shareToken": "b018172542f9a3c4d5e6f7890abcdef12345678",
"previewUrl": "https://tutorflow.io/en/platform/tests/b018172542f9a3c4d5e6f7890abcdef12345678",
"publicUrl": "https://tutorflow.io/en/platform/tests/take/b018172542f9a3c4d5e6f7890abcdef12345678",
"idempotencyKey": null,
"idempotentReplay": null,
"isTerminal": true,
"createdAt": "2026-03-24T10:32:15.108Z",
"completedAt": "2026-03-24T10:32:31.554Z"
}
],
"total": 1,
"limit": 10,
"offset": 0
}