Get trace by id | Opik Documentation

import requests
url = "http://localhost:5173/api/v1/private/traces/id"
response = requests.get(url)
print(response.json())

{
  "start_time": "2024-01-15T09:30:00Z",
  "id": "string",
  "project_id": "string",
  "name": "string",
  "end_time": "2024-01-15T09:30:00Z",
  "input": {},
  "output": {},
  "metadata": {},
  "tags": [
    "string"
  ],
  "error_info": {
    "exception_type": "string",
    "traceback": "string",
    "message": "string"
  },
  "usage": {},
  "created_at": "2024-01-15T09:30:00Z",
  "last_updated_at": "2024-01-15T09:30:00Z",
  "created_by": "string",
  "last_updated_by": "string",
  "feedback_scores": [
    {
      "name": "string",
      "value": 1.1,
      "source": "ui",
      "category_name": "string",
      "reason": "string",
      "created_at": "2024-01-15T09:30:00Z",
      "last_updated_at": "2024-01-15T09:30:00Z",
      "created_by": "string",
      "last_updated_by": "string",
      "value_by_author": {}
    }
  ],
  "span_feedback_scores": [
    {
      "name": "string",
      "value": 1.1,
      "source": "ui",
      "category_name": "string",
      "reason": "string",
      "created_at": "2024-01-15T09:30:00Z",
      "last_updated_at": "2024-01-15T09:30:00Z",
      "created_by": "string",
      "last_updated_by": "string",
      "value_by_author": {}
    }
  ],
  "comments": [
    {
      "text": "string",
      "id": "string",
      "created_at": "2024-01-15T09:30:00Z",
      "last_updated_at": "2024-01-15T09:30:00Z",
      "created_by": "string",
      "last_updated_by": "string"
    }
  ],
  "guardrails_validations": [
    {
      "span_id": "string",
      "checks": [
        {
          "name": "TOPIC",
          "result": "passed"
        }
      ]
    }
  ],
  "total_estimated_cost": 1.1,
  "span_count": 1,
  "duration": 1.1,
  "ttft": 1.1,
  "thread_id": "string",
  "visibility_mode": "default",
  "llm_span_count": 1,
  "has_tool_spans": true,
  "providers": [
    "string"
  ],
  "experiment": {
    "id": "string",
    "name": "string",
    "dataset_id": "string",
    "dataset_item_id": "string"
  }
}

Get trace by id

Path parameters

idstringRequiredformat: "uuid"

Query parameters

strip_attachmentsbooleanOptionalDefaults to false

Response

Trace resource

start_timestringformat: "date-time"

idstring or nullformat: "uuid"

project_idstring or nullRead-onlyformat: "uuid"

namestring or null

end_timestring or nullformat: "date-time"

inputmap from strings to any or list of objects or string or null

outputmap from strings to any or list of objects or string or null

metadatamap from strings to any or list of objects or string or null

tagslist of strings or null

error_infoobject or null

usagemap from strings to longs or nullRead-only

created_atstring or nullRead-onlyformat: "date-time"

last_updated_atstring or nullformat: "date-time"

created_bystring or nullRead-only

last_updated_bystring or nullRead-only

feedback_scoreslist of objects or nullRead-only

span_feedback_scoreslist of objects or nullRead-only

Aggregated feedback scores from all spans in this trace, averaged by score name

commentslist of objects or nullRead-only

guardrails_validationslist of objects or nullRead-only

total_estimated_costdouble or nullRead-only

span_countinteger or nullRead-only

durationdouble or nullRead-only

Duration in milliseconds as a decimal number to support sub-millisecond precision

ttftdouble or null

Time to first token in milliseconds

thread_idstring or null

visibility_modeenum or nullRead-only

Allowed values:

llm_span_countinteger or nullRead-only

has_tool_spansboolean or nullRead-only

providerslist of strings or nullRead-only

List of unique provider names from all spans in this trace, sorted alphabetically

experimentobject or nullRead-only

Experiment reference with ID, name, dataset ID, and dataset item ID