List Spans

GET

https://host.com/apis/intake/v2/workspaces/:workspace/spans

GET

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

$ curl https://host.com/apis/intake/v2/workspaces/workspace/spans \
>      -H "Content-Type: application/json"

1 {
2   "data": [
3     {
4       "span_id": "a3f1c9d2-4b7e-4f8a-9d3e-2b7f6c8a9e1d",
5       "session_id": "session-7890abcde123",
6       "workspace": "nemo-workspace-01",
7       "kind": "LLM",
8       "source": "otel",
9       "started_at": "2024-01-15T09:30:00Z",
10       "status": "success",
11       "ingested_at": "2024-01-15T09:30:10Z",
12       "project": "chatbot-enhancement",
13       "evaluation_context": {
14         "evaluation_id": "eval-20240115-001",
15         "evaluation_sha": "d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9",
16         "evaluation_run_id": "run-20240115-01",
17         "test_case_id": "testcase-42",
18         "metadata": {
19           "user": "qa_tester",
20           "environment": "staging"
21         }
22       },
23       "parent_span_id": "b2d3f4a5-6c7e-8f90-1234-56789abcdef0",
24       "name": "OpenAI Chat Completion",
25       "trace_id": "trace-1234abcd5678efgh9012ijkl",
26       "ended_at": "2024-01-15T09:30:05Z",
27       "error_type": "",
28       "error_message": "",
29       "provider": "openai",
30       "model": "gpt-4o-mini",
31       "prompt_id": "prompt-20240115-xyz",
32       "agent_id": "agent-007",
33       "agent_name": "claude-code",
34       "tool_name": "text-generation",
35       "input_tokens": 150,
36       "output_tokens": 200,
37       "cached_tokens": 0,
38       "total_tokens": 350,
39       "usage_details": {
40         "prompt_tokens": 150,
41         "completion_tokens": 200
42       },
43       "cost_total_usd": 0.035,
44       "cost_input_usd": 0.015,
45       "cost_output_usd": 0.02,
46       "cost_details": {
47         "prompt_cost": 0.015,
48         "completion_cost": 0.02
49       },
50       "input": "What is the capital of France?",
51       "output": "The capital of France is Paris.",
52       "raw_attributes": "{\"temperature\":0.7,\"max_tokens\":200}"
53     }
54   ],
55   "pagination": {
56     "page": 1,
57     "page_size": 10,
58     "current_page_size": 1,
59     "total_pages": 1,
60     "total_results": 1
61   },
62   "sort": "-started_at",
63   "filter": {}
64 }

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

Allowed values:

filterobjectOptional

Filter spans by session_id, trace_id, parent_span_id, project, evaluation context fields, source, kind, status, model, tool_name, provider, agent_id, agent_name, prompt_name, prompt_version, and started_at.

Response

Successful Response

datalist of objects

paginationobject

Pagination information.

sortstring

The field on which the results are sorted.

filtermap from strings to any

Filtering information.

Errors

422

Unprocessable Entity Error