Retrieve a testset | Respan Docs

Retrieve a testset by ID.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Path parameters

testset_idstringRequired

The testset ID returned as id by the API.

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.

descriptionstring

Testset description.

Errors

401

Unauthorized Error

404

Not Found Error

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	}

$	curl https://api.respan.ai/api/testsets/testset_id/ \
>	-H "Authorization: Bearer <respanApiKey>"