For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Copy to LLMGithubGo to App
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
    • Overview
  • Python SDK
    • Reference
    • REST API Client
  • Typescript SDK
    • Overview
    • Opik TS
    • Prompts
    • Opik Query Language (OQL)
  • Rest API
    • Overview
        • POSTAdd thread comment
        • POSTAdd trace comment
        • PUTAdd trace feedback score
        • POSTCreate traces
        • PATCHBatch update traces
        • PATCHBatch update threads
        • PUTClose trace thread(s)
        • GETGet traces by project_name or project_id
        • POSTCreate trace
        • GETGet trace by id
        • DELDelete trace by id
        • PATCHUpdate trace by id
        • POSTDelete thread comments
        • POSTDelete thread feedback scores
        • POSTDelete trace comments
        • POSTDelete trace feedback score
        • POSTDelete trace threads
        • POSTDelete traces
        • GETFind Feedback Score names
        • GETFind Trace Threads Feedback Score names
        • GETGet trace stats
        • GETGet thread comment
        • GETGet trace thread stats
        • GETGet trace comment
        • POSTGet trace thread
        • GETGet trace threads
        • PUTOpen trace thread
        • PUTBatch feedback scoring for threads
        • PUTBatch feedback scoring for traces
        • POSTSearch trace threads
        • POSTSearch traces
        • PATCHUpdate thread
        • PATCHUpdate thread comment by id
        • PATCHUpdate trace comment by id
LogoLogo
Copy to LLMGithubGo to App
Rest APIAPI ReferenceTraces

Get traces by project_name or project_id

GET
/v1/private/traces
GET
/api/v1/private/traces
$curl http://localhost:5173/api/v1/private/traces
200Retrieved
1{
2  "page": 1,
3  "size": 1,
4  "total": 1,
5  "content": [
6    {
7      "start_time": "2024-01-15T09:30:00Z",
8      "id": "string",
9      "project_id": "string",
10      "name": "string",
11      "end_time": "2024-01-15T09:30:00Z",
12      "input": {},
13      "output": {},
14      "metadata": {},
15      "tags": [
16        "string"
17      ],
18      "error_info": {
19        "exception_type": "string",
20        "traceback": "string",
21        "message": "string"
22      },
23      "usage": {},
24      "created_at": "2024-01-15T09:30:00Z",
25      "last_updated_at": "2024-01-15T09:30:00Z",
26      "created_by": "string",
27      "last_updated_by": "string",
28      "feedback_scores": [
29        {
30          "name": "string",
31          "value": 1.1,
32          "source": "ui",
33          "category_name": "string",
34          "reason": "string",
35          "created_at": "2024-01-15T09:30:00Z",
36          "last_updated_at": "2024-01-15T09:30:00Z",
37          "created_by": "string",
38          "last_updated_by": "string",
39          "value_by_author": {}
40        }
41      ],
42      "span_feedback_scores": [
43        {
44          "name": "string",
45          "value": 1.1,
46          "source": "ui",
47          "category_name": "string",
48          "reason": "string",
49          "created_at": "2024-01-15T09:30:00Z",
50          "last_updated_at": "2024-01-15T09:30:00Z",
51          "created_by": "string",
52          "last_updated_by": "string",
53          "value_by_author": {}
54        }
55      ],
56      "comments": [
57        {
58          "text": "string",
59          "id": "string",
60          "created_at": "2024-01-15T09:30:00Z",
61          "last_updated_at": "2024-01-15T09:30:00Z",
62          "created_by": "string",
63          "last_updated_by": "string"
64        }
65      ],
66      "guardrails_validations": [
67        {
68          "span_id": "string",
69          "checks": [
70            {
71              "name": "TOPIC",
72              "result": "passed"
73            }
74          ]
75        }
76      ],
77      "total_estimated_cost": 1.1,
78      "span_count": 1,
79      "duration": 1.1,
80      "ttft": 1.1,
81      "thread_id": "string",
82      "visibility_mode": "default",
83      "llm_span_count": 1,
84      "has_tool_spans": true,
85      "providers": [
86        "string"
87      ],
88      "experiment": {
89        "id": "string",
90        "name": "string",
91        "dataset_id": "string",
92        "dataset_item_id": "string"
93      },
94      "source": "sdk",
95      "environment": "string"
96    }
97  ],
98  "sortableBy": [
99    "string"
100  ]
101}

Get traces by project_name or project_id

Was this page helpful?
Previous

Create trace

Next
Built with

Query parameters

pageintegerOptional>=1Defaults to 1
sizeintegerOptional>=1Defaults to 10
project_namestringOptional
project_idstringOptionalformat: "uuid"
filtersstringOptional
truncatebooleanOptionalDefaults to false
strip_attachmentsbooleanOptionalDefaults to false
sortingstringOptional
excludestringOptional
searchstringOptional
from_timedatetimeOptional
to_timedatetimeOptional

Response

Trace resource
pageinteger
sizeinteger
totallong
contentlist of objects
sortableBylist of strings