List Spans

GET

///apis/intake/v2/workspaces/:workspace/spans

GET

/apis/intake/v2/workspaces/:workspace/spans

curl /apis/intake/v2/workspaces/workspace/spans

{
  "data": [
    {
      "span_id": "string",
      "session_id": "string",
      "workspace": "string",
      "kind": "LLM",
      "source": "string",
      "started_at": "2024-01-15T09:30:00Z",
      "status": "success",
      "ingested_at": "2024-01-15T09:30:00Z",
      "project": "string",
      "evaluation_context": {
        "evaluation_name": "string",
        "test_case_name": "string",
        "evaluation_id": "string",
        "test_case_id": "string"
      },
      "parent_span_id": "string",
      "name": "string",
      "trace_id": "string",
      "ended_at": "2024-01-15T09:30:00Z",
      "error_type": "string",
      "error_message": "string",
      "provider": "string",
      "model": "string",
      "prompt_id": "string",
      "agent_id": "string",
      "agent_name": "string",
      "tool_name": "string",
      "input_tokens": 1,
      "output_tokens": 1,
      "cached_tokens": 1,
      "total_tokens": 1,
      "usage_details": {},
      "cost_total_usd": 1.1,
      "cost_input_usd": 1.1,
      "cost_output_usd": 1.1,
      "cost_details": {},
      "input": "string",
      "output": "string",
      "raw_attributes": "string"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 1,
    "current_page_size": 1,
    "total_pages": 1,
    "total_results": 1
  },
  "sort": "string",
  "filter": {}
}

Path parameters

workspacestringRequired

Query parameters

pageintegerOptional>=1Defaults to 1

Page number.

page_sizeintegerOptional1-1000Defaults to 10

Page size.

sortenumOptionalDefaults to -started_at

Allowed values:

modeenumOptionalDefaults to detailed

Response mode. summary omits payloads and raw attributes; preview includes input and output truncated to 300 characters; detailed returns full payloads and raw attributes.

Allowed values:

filterobjectOptional

Filter spans by session_id, trace_id, parent_span_id, project, evaluation_name, test_case_name, source, kind, status, model, tool_name, provider, agent_id, agent_name, and started_at. Every field takes one exact value, except started_at, which takes gte and lte.

Response

Successful Response

datalist of objects

paginationobjectOptional

Pagination information.

sortstringOptional

The field on which the results are sorted.

filtermap from strings to anyOptional

Filtering information.

Errors

422

Unprocessable Entity Error