Get Trace

Get full trace with all spans as a tree structure

GET /v1/traces/{trace_id}

cURL

curl https://api.playgent.com/v1/traces/trace_ghi789 \
  -H "Authorization: Bearer your-api-key"

Response

{
  "trace_id": "trace_ghi789",
  "agent_id": "agent_abc123",
  "run_id": "run_def456",
  "status": "completed",
  "duration_ms": 4560,
  "total_cost_usd": 0.0234,
  "spans": [
    {
      "span_id": "span_jkl012",
      "name": "agent_execution",
      "kind": "agent",
      "duration_ms": 4560,
      "children": [
        {
          "span_id": "span_mno345",
          "name": "gpt-4-turbo call",
          "kind": "llm",
          "model": "gpt-4-turbo",
          "tokens": { "input": 234, "output": 156 },
          "cost_usd": 0.0089,
          "duration_ms": 1234
        },
        {
          "span_id": "span_pqr678",
          "name": "search_knowledge_base",
          "kind": "tool",
          "duration_ms": 456,
          "children": [
            {
              "span_id": "span_stu901",
              "name": "embedding generation",
              "kind": "llm",
              "model": "text-embedding-3-small",
              "duration_ms": 89
            }
          ]
        }
      ]
    }
  ]
}

Retrieve the complete trace with all spans organized in a hierarchical tree structure.

trace_id · string · required

Trace identifier

trace_id · string · required

Trace identifier

agent_id · string · required

Associated agent ID

run_id · string

Linked test run ID (if any)

status · string · required

Trace status: running, completed, error

duration_ms · integer · required

Total trace duration in milliseconds

total_cost_usd · number · required

Total cost across all spans

spans · array · required

Hierarchical span tree

Show span object

span_id · string

Span identifier

name · string

Span name

kind · string

Span type

duration_ms · integer

Duration

model · string

Model used (LLM spans)

tokens · object

Token usage

cost_usd · number

Cost

children · array

Nested child spans

cURL

curl https://api.playgent.com/v1/traces/trace_ghi789 \
  -H "Authorization: Bearer your-api-key"

Response

{
  "trace_id": "trace_ghi789",
  "agent_id": "agent_abc123",
  "run_id": "run_def456",
  "status": "completed",
  "duration_ms": 4560,
  "total_cost_usd": 0.0234,
  "spans": [
    {
      "span_id": "span_jkl012",
      "name": "agent_execution",
      "kind": "agent",
      "duration_ms": 4560,
      "children": [
        {
          "span_id": "span_mno345",
          "name": "gpt-4-turbo call",
          "kind": "llm",
          "model": "gpt-4-turbo",
          "tokens": { "input": 234, "output": 156 },
          "cost_usd": 0.0089,
          "duration_ms": 1234
        },
        {
          "span_id": "span_pqr678",
          "name": "search_knowledge_base",
          "kind": "tool",
          "duration_ms": 456,
          "children": [
            {
              "span_id": "span_stu901",
              "name": "embedding generation",
              "kind": "llm",
              "model": "text-embedding-3-small",
              "duration_ms": 89
            }
          ]
        }
      ]
    }
  ]
}