List dataset logs | Respan Docs

curl -X POST https://api.respan.ai/api/datasets/dataset_id/logs/list/ \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json" \
     -d '{
  "filters": {
    "status_code": {
      "operator": "eq",
      "value": 200
    }
  },
  "is_exporting": false
}'

{
  "count": 250,
  "next": "https://api.respan.ai/api/datasets/6dee217e-18c6-468e-ab6d-7b97e2115752/logs/list/?page=2&page_size=10",
  "results": [
    {
      "id": "abc123",
      "unique_id": "abc123",
      "organization_id": "8264a3f4-40c7-476a-97d1-96908127ea21",
      "environment": "prod",
      "timestamp": "2025-10-06T02:40:29.250313Z",
      "start_time": "2025-10-06T02:40:29.250313Z",
      "prompt_tokens": 2020,
      "completion_tokens": 25,
      "total_request_tokens": 2045,
      "cost": 0.0010475,
      "model": "gpt-4o-mini",
      "latency": 0.516,
      "status_code": 200,
      "status": "success",
      "prompt": "Hi, this is Taylor calling from HONK...",
      "completion": "Alright, so that is about 120 minutes...",
      "input": {
        "messages": [
          {
            "role": "user",
            "content": "Hi"
          }
        ]
      },
      "output": {
        "role": "assistant",
        "content": "Hello there"
      },
      "dataset_id": "6dee217e-18c6-468e-ab6d-7b97e2115752",
      "annotation_status": "completed",
      "annotation_completed_by": {
        "first_name": "",
        "last_name": "",
        "email": ""
      },
      "scores": {},
      "metadata": {
        "provider": "openai"
      },
      "custom_identifier": "support-log-1",
      "log_type": "chat"
    }
  ],
  "total_count": 250,
  "current_filters": {},
  "filters_data": {},
  "filter_options": {}
}

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.

Path parameters

dataset_idstringRequired

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

Query parameters

pageintegerOptionalDefaults to 1

Page number.

page_sizeintegerOptional<=100Defaults to 25

Results per page. Maximum is 100.

sort_bystringOptionalDefaults to -timestamp

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

retrieval_modeenumOptional

Set to async to preload full log objects in the background.

Allowed values:

include_fieldsstringOptional

Comma-separated list of response fields to include.

Request

This endpoint expects an object.

filtersmap from strings to objectsOptional

Platform-standard filters keyed by field name.

is_exportingbooleanOptional

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

export_formatenumOptional

Export format. Defaults to .csv.

Allowed values:

namestringOptional

Optional export file name.

Response

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

object

Errors

401

Unauthorized Error

Path parameters

Headers

Query parameters

Request

Response

Errors