Retrieve an experiment trace

curl https://api.respan.ai/api/v2/experiments/experiment_id/logs/log_id/ \
     -H "Authorization: Bearer sk_live_xxxxx" \
     -H "Content-Type: application/json"

{
  "id": "trace_789abc",
  "trace_unique_id": "trace_789abc",
  "root_span_unique_id": "root_span_123xyz",
  "environment": "production",
  "customer_identifier": "customer_42",
  "name": "Dataset Entry 1",
  "input": {
    "prompt": "Translate the following English text to French: 'Hello, how are you?'"
  },
  "output": {
    "translation": "Bonjour, comment ça va ?"
  },
  "expected_output": {
    "translation": "Bonjour, comment allez-vous ?"
  },
  "status": "success",
  "comparison_key": "translate_en_fr_001",
  "start_time": "2024-01-15T09:30:00Z",
  "end_time": "2024-01-15T09:30:01Z",
  "duration": 1,
  "span_count": 3,
  "llm_call_count": 1,
  "total_cost": 0.0012,
  "total_tokens": 45,
  "total_prompt_tokens": 20,
  "total_completion_tokens": 25,
  "error_count": 0,
  "scores": {
    "evaluator_grammar": {
      "evaluator_id": "evaluator_grammar",
      "evaluator_slug": "grammar_check",
      "evaluator_name": "Grammar Evaluator",
      "score_value_type": "numerical",
      "numerical_value": 0.95,
      "avg_score": 0.95
    },
    "evaluator_fluency": {
      "evaluator_id": "evaluator_fluency",
      "evaluator_slug": "fluency_check",
      "evaluator_name": "Fluency Evaluator",
      "score_value_type": "percentage",
      "numerical_value": 92.5,
      "avg_score": 92.5
    }
  },
  "span_tree": [
    {
      "id": "span_001",
      "trace_unique_id": "trace_789abc",
      "root_span_unique_id": "root_span_123xyz",
      "environment": "production",
      "customer_identifier": "customer_42",
      "name": "Dataset Entry 1",
      "input": {
        "prompt": "Translate the following English text to French: 'Hello, how are you?'"
      },
      "output": {
        "translation": "Bonjour, comment ça va ?"
      },
      "expected_output": {
        "translation": "Bonjour, comment allez-vous ?"
      },
      "status": "success",
      "comparison_key": "translate_en_fr_001",
      "start_time": "2024-01-15T09:30:00Z",
      "end_time": "2024-01-15T09:30:01Z",
      "duration": 1,
      "span_count": 1,
      "llm_call_count": 1,
      "total_cost": 0.0012,
      "total_tokens": 45,
      "total_prompt_tokens": 20,
      "total_completion_tokens": 25,
      "error_count": 0,
      "scores": {
        "evaluator_grammar": {
          "evaluator_id": "evaluator_grammar",
          "evaluator_slug": "grammar_check",
          "evaluator_name": "Grammar Evaluator",
          "score_value_type": "numerical",
          "numerical_value": 0.95,
          "avg_score": 0.95
        },
        "evaluator_fluency": {
          "evaluator_id": "evaluator_fluency",
          "evaluator_slug": "fluency_check",
          "evaluator_name": "Fluency Evaluator",
          "score_value_type": "percentage",
          "numerical_value": 92.5,
          "avg_score": 92.5
        }
      },
      "span_name": "workflow.completion",
      "log_type": "chat",
      "model": "gpt-4",
      "children": [
        {}
      ]
    }
  ]
}

Retrieve one experiment trace with its full span tree and enriched evaluator scores.

Path parameters

experiment_idstringRequired

Experiment ID returned as id in experiment responses.

log_idstringRequired

Trace ID returned as id in experiment trace list responses.

Response

Experiment trace details.

idstring

Trace ID. Use this value as log_id for trace detail and wait-workflow resume routes.

trace_unique_idstring

Trace unique ID.

root_span_unique_idstring or null

environmentstring or null

customer_identifierstring or null

namestring or null

inputany or null

Trace input. May be a JSON value or serialized JSON string depending on storage.

outputany or null

Trace output. May be a JSON value or serialized JSON string depending on storage.

expected_outputany or null

Expected output from the dataset row, when available.

statusstring or null

comparison_keystring or null

Stable key for comparing the same input across experiments.

start_timedatetime or null

end_timedatetime or null

durationdouble or null

Trace duration in seconds.

span_countinteger or null

llm_call_countinteger or null

total_costdouble or null

total_tokensinteger or null

total_prompt_tokensinteger or null

total_completion_tokensinteger or null

error_countinteger or null

scoresmap from strings to objects

Scores keyed by evaluator ID or slug. Each value includes evaluator metadata and the score value field matching score_value_type.

span_treelist of objects

Hierarchical span tree for this trace.

Errors

401

Unauthorized Error

404

Not Found Error

Path parameters

Headers

Response

Errors