API ReferenceTestsets

List testset rows

List rows in a testset.

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, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

OR
AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

testset_idstringRequired

The testset ID returned as id by the API.

Query parameters

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

Response

Paginated row list.
countinteger
Number of rows returned in this page.
resultslist of objects
Array of testset rows.
nextstring or nullOptional
URL for the next page, if any.
previousstring or nullOptional
URL for the previous page, if any.
current_filtersobjectOptional
Current filter state returned by the paginator.

Errors

401
Unauthorized Error
404
Not Found Error