Retrieve an experiment trace

GET

https://api.respan.ai/api/v2/experiments/:experiment_id/logs/:log_id/

GET

/api/v2/experiments/:experiment_id/logs/:log_id/

$ curl https://api.respan.ai/api/v2/experiments/experiment_id/logs/log_id/ \
>      -H "Authorization: Bearer <respanApiKey>"

1 {
2   "id": "trace_456",
3   "trace_unique_id": "trace_456",
4   "root_span_unique_id": "string",
5   "environment": "prod",
6   "customer_identifier": "string",
7   "name": "Dataset Entry 1",
8   "input": null,
9   "output": null,
10   "expected_output": null,
11   "status": "success",
12   "comparison_key": "string",
13   "start_time": "2024-01-15T09:30:00Z",
14   "end_time": "2024-01-15T09:30:00Z",
15   "duration": 1.1,
16   "span_count": 1,
17   "llm_call_count": 1,
18   "total_cost": 0.0012,
19   "total_tokens": 1,
20   "total_prompt_tokens": 1,
21   "total_completion_tokens": 1,
22   "error_count": 1,
23   "scores": {},
24   "span_tree": [
25     {
26       "id": "trace_456",
27       "trace_unique_id": "trace_456",
28       "root_span_unique_id": "string",
29       "environment": "prod",
30       "customer_identifier": "string",
31       "name": "Dataset Entry 1",
32       "input": null,
33       "output": null,
34       "expected_output": null,
35       "status": "success",
36       "comparison_key": "string",
37       "start_time": "2024-01-15T09:30:00Z",
38       "end_time": "2024-01-15T09:30:00Z",
39       "duration": 1.1,
40       "span_count": 1,
41       "llm_call_count": 1,
42       "total_cost": 0.0012,
43       "total_tokens": 1,
44       "total_prompt_tokens": 1,
45       "total_completion_tokens": 1,
46       "error_count": 1,
47       "scores": {},
48       "span_name": "workflow.completion",
49       "log_type": "chat",
50       "model": "string",
51       "children": [
52         {}
53       ]
54     }
55   ]
56 }

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

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

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_idstringOptional

Trace unique ID.

root_span_unique_idstring or nullOptional

environmentstring or nullOptional

customer_identifierstring or nullOptional

namestring or nullOptional

inputany or nullOptional

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

outputany or nullOptional

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

expected_outputany or nullOptional

Expected output from the dataset row, when available.

statusstring or nullOptional

comparison_keystring or nullOptional

Stable key for comparing the same input across experiments.

start_timedatetime or nullOptional

end_timedatetime or nullOptional

durationdouble or nullOptional

Trace duration in seconds.

span_countinteger or nullOptional

llm_call_countinteger or nullOptional

total_costdouble or nullOptional

total_tokensinteger or nullOptional

total_prompt_tokensinteger or nullOptional

total_completion_tokensinteger or nullOptional

error_countinteger or nullOptional

scoresmap from strings to objectsOptional

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

span_treelist of objectsOptional

Hierarchical span tree for this trace.

Errors

401

Unauthorized Error

404

Not Found Error

413

Content Too Large Error