Skip to content
REST API

List practice tests

GET
/tests

Newest first, with each test's best score and the attempt in progress. Questions are not listed.

Required scopes: tests:view

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

limit?integer

Page size, 1-100.

Range1 <= value <= 100
Default25
cursor?|

Opaque. Pass nextCursor from the previous page unchanged.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/tests"
{  "data": [    {      "id": "6e5d4c3b-2a19-4f08-8e7d-6c5b4a392817",      "name": "Cell biology quiz",      "assisted": false,      "status": "ready",      "error": null,      "createdAt": "2026-01-15T09:30:00.000Z",      "questionCount": 2,      "requestedLength": 2,      "kinds": [        "MCQ",        "SHORT"      ],      "timerSecs": 600,      "attemptCount": 1,      "bestRatio": 0.5,      "bestAssistedRatio": null,      "openAttemptId": null    }  ],  "nextCursor": null}