Get trace by id | Opik Documentation

curl http://localhost:5173/api/v1/private/traces/id \
     -H "Content-Type: application/json"

{
  "start_time": "2024-01-15T09:30:00Z",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "project_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "User Signup Flow Trace",
  "end_time": "2024-01-15T09:45:00Z",
  "input": [
    "{\"username\": \"johndoe\", \"email\": \"john@example.com\"}"
  ],
  "output": [
    "{\"status\": \"success\", \"user_id\": \"12345\"}"
  ],
  "metadata": {
    "environment": "production",
    "version": "1.2.3"
  },
  "tags": [
    "signup",
    "user-flow"
  ],
  "error_info": {
    "exception_type": "ValueError",
    "traceback": "Traceback (most recent call last):\n  File \"signup.py\", line 42, in validate_email\n    raise ValueError(\"Invalid email format\")",
    "message": "Invalid email format"
  },
  "usage": {
    "token_count": 256,
    "api_calls": 3
  },
  "created_at": "2024-01-15T09:30:00Z",
  "last_updated_at": "2024-01-15T09:50:00Z",
  "created_by": "alice@example.com",
  "last_updated_by": "bob@example.com",
  "feedback_scores": [
    {
      "name": "accuracy",
      "value": 95.5,
      "source": "ui",
      "category_name": "performance",
      "reason": "High accuracy in user data processing",
      "created_at": "2024-01-15T10:00:00Z",
      "last_updated_at": "2024-01-15T10:05:00Z",
      "created_by": "alice@example.com",
      "last_updated_by": "alice@example.com",
      "value_by_author": {
        "alice@example.com": {
          "value": 95.5,
          "reason": "Reviewed and confirmed",
          "category_name": "performance",
          "source": "ui",
          "last_updated_at": "2024-01-15T10:05:00Z",
          "span_type": "validation",
          "span_id": "span-1234"
        }
      }
    }
  ],
  "span_feedback_scores": [
    {
      "name": "latency",
      "value": 120,
      "source": "sdk",
      "category_name": "performance",
      "reason": "Measured latency in ms",
      "created_at": "2024-01-15T10:10:00Z",
      "last_updated_at": "2024-01-15T10:15:00Z",
      "created_by": "bob@example.com",
      "last_updated_by": "bob@example.com",
      "value_by_author": {
        "bob@example.com": {
          "value": 120,
          "reason": "Automated measurement",
          "category_name": "performance",
          "source": "sdk",
          "last_updated_at": "2024-01-15T10:15:00Z",
          "span_type": "execution",
          "span_id": "span-5678"
        }
      }
    }
  ],
  "comments": [
    {
      "text": "Trace looks good, no issues found.",
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "created_at": "2024-01-15T10:20:00Z",
      "last_updated_at": "2024-01-15T10:25:00Z",
      "created_by": "carol@example.com",
      "last_updated_by": "carol@example.com"
    }
  ],
  "guardrails_validations": [
    {
      "span_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "checks": [
        {
          "name": "TOPIC",
          "result": "passed"
        },
        {
          "name": "PII",
          "result": "passed"
        }
      ]
    }
  ],
  "total_estimated_cost": 0.023,
  "span_count": 12,
  "duration": 900000.123,
  "ttft": 150.75,
  "thread_id": "thread-42",
  "visibility_mode": "default",
  "llm_span_count": 5,
  "has_tool_spans": false,
  "providers": [
    "OpenAI",
    "HuggingFace"
  ],
  "experiment": {
    "id": "9b2d6f3a-1c4e-4f3a-8a2b-3f4e5d6c7b8a",
    "name": "Signup Flow Optimization",
    "dataset_id": "4a5b6c7d-8e9f-0a1b-2c3d-4e5f6a7b8c9d",
    "dataset_item_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
  },
  "source": "sdk"
}

Get trace by id

Path parameters

idstringRequiredformat: "uuid"

Query parameters

strip_attachmentsbooleanOptionalDefaults to false

Response

Trace resource

start_timedatetime

idstringformat: "uuid"

project_idstringRead-onlyformat: "uuid"

namestring

end_timedatetime

inputmap from strings to any or list of objects or string

outputmap from strings to any or list of objects or string

metadatamap from strings to any or list of objects or string

tagslist of strings

error_infoobject

usagemap from strings to longsRead-only

created_atdatetimeRead-only

last_updated_atdatetime

created_bystringRead-only

last_updated_bystringRead-only

feedback_scoreslist of objectsRead-only

span_feedback_scoreslist of objectsRead-only

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

commentslist of objectsRead-only

guardrails_validationslist of objectsRead-only

total_estimated_costdoubleRead-only

span_countintegerRead-only

durationdoubleRead-only

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

ttftdouble

Time to first token in milliseconds

thread_idstring

visibility_modeenumRead-only

Allowed values:

llm_span_countintegerRead-only

has_tool_spansbooleanRead-only

providerslist of stringsRead-only

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

experimentobjectRead-only

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

sourceenum

Allowed values: