Get trace by id

GET

/v1/private/traces/:id

GET

/api/v1/private/traces/:id

curl http://localhost:5173/api/v1/private/traces/id

200Retrieved

{
  "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",
      "source_queue_id": "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",
      "source_queue_id": "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",
      "source_queue_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"
  },
  "annotation_queues": [
    {
      "id": "string",
      "name": "string"
    }
  ],
  "source": "sdk",
  "environment": "string"
}

Get trace by id

Path parameters

idstringRequiredformat: "uuid"

Query parameters

strip_attachmentsbooleanOptionalDefaults to false

If true, returns attachment references like [file.png]; if false, downloads and reinjects attachment content from S3 (default: false for backward compatibility)

Response

Trace resource

start_timedatetime

idstringOptionalformat: "uuid"

project_idstringOptionalRead-onlyformat: "uuid"

namestringOptional

end_timedatetimeOptional

inputmap from strings to any or list of objects or stringOptional

outputmap from strings to any or list of objects or stringOptional

metadatamap from strings to any or list of objects or stringOptional

tagslist of stringsOptional

error_infoobjectOptional

usagemap from strings to longsOptionalRead-only

created_atdatetimeOptionalRead-only

last_updated_atdatetimeOptional

created_bystringOptionalRead-only

last_updated_bystringOptionalRead-only

feedback_scoreslist of objectsOptionalRead-only

span_feedback_scoreslist of objectsOptionalRead-only

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

commentslist of objectsOptionalRead-only

guardrails_validationslist of objectsOptionalRead-only

total_estimated_costdoubleOptionalRead-only

span_countintegerOptionalRead-only

durationdoubleOptionalRead-only

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

ttftdoubleOptional

Time to first token in milliseconds

thread_idstringOptional

visibility_modeenumOptionalRead-only

Allowed values:

llm_span_countintegerOptionalRead-only

has_tool_spansbooleanOptionalRead-only

providerslist of stringsOptionalRead-only

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

experimentobjectOptionalRead-only

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

annotation_queueslist of objectsOptionalRead-only

Annotation queues this trace is currently an item of

sourceenumOptional

Allowed values:

environmentstringOptional0-150 characters