Sign in
datasets

List dataset logs

List logs in a dataset with filters and pagination. Set is_exporting=true to trigger an asynchronous CSV or JSONL export instead of returning results.

post/api/datasets/{dataset_id}/logs/list/

Path parameters

dataset_idstring required

Dataset ID. Use _saved_logs for the virtual saved-logs collection.

Query parameters

pageinteger

Page number.

page_sizeinteger

Results per page. Maximum is 100.

sort_bystring

Sort field for dataset logs. Prefix with - for descending order.

include_fieldsstring

Comma-separated list of response fields to include.

Headers

Authorizationstring required

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.

Request body

filtersobject

Platform-standard filters keyed by field name.

is_exportingboolean

Set to true to export logs instead of returning a paginated list.

export_format'.csv' | '.jsonl'

Export format. Defaults to .csv.

namestring

Optional export file name.

Response

Paginated dataset logs, or an export acknowledgement when is_exporting=true.

OR

Changes