List Traces

GET

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

GET

/apis/intake/v2/workspaces/:workspace/traces

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

1 {
2   "data": [
3     {
4       "id": "trace_9f8b7c6d5e4a3b2c1d0e",
5       "session_id": "session_20240115_093000",
6       "workspace": "nemo_workspace_01",
7       "started_at": "2024-01-15T09:30:00Z",
8       "status": "success",
9       "root_span_id": "span_1234567890abcdef",
10       "name": "User Login Flow",
11       "experiment_context": {
12         "experiment_id": "exp_2024_q1_login_test",
13         "test_case_id": "tc_001"
14       },
15       "ended_at": "2024-01-15T09:30:01Z",
16       "duration_ms": 1050.5,
17       "input_tokens": 150,
18       "output_tokens": 300,
19       "cached_tokens": 50,
20       "total_tokens": 400,
21       "cost_usd": 0.0125,
22       "cost_input_usd": 0.0045,
23       "cost_output_usd": 0.008,
24       "span_count": 5,
25       "error_count": 0
26     }
27   ],
28   "pagination": {
29     "page": 1,
30     "page_size": 10,
31     "current_page_size": 1,
32     "total_pages": 1,
33     "total_results": 1
34   },
35   "sort": "-started_at",
36   "filter": {}
37 }

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

Use summary for root-span trace fields only, or detailed to include token, cost, and span-count rollups.

Allowed values:

filterobjectOptional

Filter root-span-backed traces by id, session_id, root status, root span started_at, experiment_id, and test_case_id.

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