For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • POSTCreate a testset
      • POSTList testsets
      • GETRetrieve a testset
      • PATCHUpdate a testset
      • DELDelete a testset
      • POSTCreate testset rows
      • GETList testset rows
      • PATCHUpdate a testset row
      • DELDelete a testset row
      • GETGet testsets summary
      • POSTGet filtered testsets summary
      • PUTReplace a testset
      • DELDelete testset rows
      • GETRetrieve a testset row
      • PUTReplace a testset row
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceTestsets

List testsets

POST
https://api.respan.ai/api/testsets/list/
POST
/api/testsets/list/
$curl -X POST "https://api.respan.ai/api/testsets/list/?sort_by=-created_at" \
>     -H "Authorization: Bearer sk_live_xxxxx" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "count": 1,
3  "results": [
4    {
5      "id": "6f41f95bb8c04656b6f6d9d5a98f4f2c",
6      "name": "QA Test Set",
7      "created_at": "2026-01-15T09:30:00Z",
8      "updated_at": "2026-01-15T09:30:00Z",
9      "current_max_row_index": 2,
10      "project": null,
11      "column_definitions": [
12        {
13          "field": "input",
14          "mapped_name": "question",
15          "type": "text"
16        },
17        {
18          "field": "expected_output",
19          "type": "text"
20        }
21      ]
22    }
23  ],
24  "next": null,
25  "previous": null,
26  "current_filters": {
27    "name": {
28      "value": "QA"
29    }
30  },
31  "filters_data": {}
32}
List testsets with pagination and optional filters.
Was this page helpful?
Previous

Retrieve a testset

Next
Built with

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Query parameters

pageintegerOptional>=1
Page number.
page_sizeintegerOptional1-100
Number of results to return per page. Maximum 100.
sort_bystringOptional

Sort field. Common values include -created_at, name, and updated_at.

Request

This endpoint expects an object.
filtersobjectOptional
Filter criteria using the standard Respan filter format.

Response

Paginated testset list.
countinteger
Number of testsets returned in this page.
resultslist of objects
Array of testsets.
nextstring or null
URL for the next page, if any.
previousstring or null
URL for the previous page, if any.
current_filtersobject
Normalized filters applied to this response.
filters_dataobject
Available filter definitions for building list queries.

Errors

400
Bad Request Error
401
Unauthorized Error