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

Retrieve a testset

GET
https://api.respan.ai/api/testsets/:testset_id/
GET
/api/testsets/:testset_id/
$curl https://api.respan.ai/api/testsets/testset_id/ \
>     -H "Authorization: Bearer sk_live_xxxxx"
1{
2  "id": "6f41f95bb8c04656b6f6d9d5a98f4f2c",
3  "name": "QA Test Set",
4  "created_at": "2026-01-15T09:30:00Z",
5  "updated_at": "2026-01-15T09:30:00Z",
6  "current_max_row_index": 2,
7  "project": null,
8  "column_definitions": [
9    {
10      "field": "input",
11      "mapped_name": "question",
12      "type": "text"
13    },
14    {
15      "field": "expected_output",
16      "type": "text"
17    }
18  ]
19}
Retrieve a testset by ID.
Was this page helpful?
Previous

Update a testset

Next
Built with

Path parameters

testset_idstringRequired

The testset ID returned as id by the API.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Response

Testset details.
idstring
Public testset ID.
namestring
Testset name.
created_atdatetime
When the testset was created.
updated_atdatetime
When the testset was last updated.
current_max_row_indexdouble
Highest row index currently present in the testset.
projectstring or null
Project identifier when the testset is associated with a project.
column_definitionslist of objects
Configured columns for testset rows.

Errors

401
Unauthorized Error
404
Not Found Error