Retrieve a public trace

GET

https://api.respan.ai/api/:unique_organization_id/traces/:trace_unique_id/

GET

/api/:unique_organization_id/traces/:trace_unique_id/

$ curl https://api.respan.ai/api/unique_organization_id/traces/trace_unique_id/

1 {
2   "id": "trace_abc123",
3   "trace_unique_id": "trace_abc123",
4   "root_span_unique_id": "span_root_123",
5   "unique_organization_id": "org_xyz789",
6   "organization_id": "org_xyz789",
7   "organization_name": "Acme Inc",
8   "environment": "prod",
9   "customer_identifier": "user@example.com",
10   "start_time": "2024-01-15T10:30:00Z",
11   "end_time": "2024-01-15T10:30:02.500000Z",
12   "duration": 2.5,
13   "span_count": 3,
14   "llm_call_count": 2,
15   "total_cost": 0.00345,
16   "total_prompt_tokens": 150,
17   "total_completion_tokens": 75,
18   "total_tokens": 225,
19   "error_count": 0,
20   "name": "chat_completion",
21   "input": "[{\"role\": \"user\", \"content\": \"Explain quantum computing\"}]",
22   "output": "{\"role\": \"assistant\", \"content\": \"Quantum computing is a revolutionary technology...\"}",
23   "metadata": {
24     "user_id": "user123"
25   },
26   "trace_group_identifier": "workflow_v1",
27   "session_identifier": "session456",
28   "model": "gpt-4",
29   "span_tree": [
30     {
31       "id": "log_root_1",
32       "unique_id": "log_root_1",
33       "span_unique_id": "span_root_123",
34       "span_name": "chat_completion",
35       "span_parent_id": null,
36       "trace_unique_id": "trace_abc123",
37       "log_type": "chat",
38       "timestamp": "2024-01-15T10:30:02Z",
39       "start_time": "2024-01-15T10:30:00Z",
40       "prompt_tokens": 50,
41       "completion_tokens": 75,
42       "cost": 0.00345,
43       "model": "gpt-4",
44       "latency": 2,
45       "status_code": 200,
46       "status": "success",
47       "input": "[{\"role\": \"user\", \"content\": \"Explain quantum computing\"}]",
48       "output": "{\"role\": \"assistant\", \"content\": \"Quantum computing is a revolutionary technology...\"}",
49       "children": []
50     }
51   ]
52 }

Retrieve a publicly shared trace without authentication. The trace must have been shared first via PATCH /api/traces/{trace_unique_id}/. Metadata keys beginning with _ are reserved for platform use and are omitted from customer-facing span and trace responses, so they do not round-trip through read APIs.

Path parameters

unique_organization_idstringRequired

Organization unique ID used in a public trace share link.

trace_unique_idstringRequired

Unique trace identifier.

Response

Trace detail with span tree.

idstringOptional

Trace identifier.

trace_unique_idstringOptional

Unique trace identifier.

root_span_unique_idstringOptional

Root span ID for the trace.

unique_organization_idstringOptional

Organization unique ID.

organization_idstringOptional

Alias of unique_organization_id.

organization_namestringOptional

Organization name when available.

organization_key_idstringOptional

API key identifier used to create the trace.

environmentstringOptional

Environment for the trace.

customer_identifierstringOptional

Customer or user identifier.

start_timedatetimeOptional

When the trace started.

end_timedatetimeOptional

When the trace ended.

durationdoubleOptional

Total duration in seconds.

span_countintegerOptional

Total spans in the trace.

llm_call_countintegerOptional

Number of LLM-call spans.

total_costdoubleOptional

Total cost in USD.

total_prompt_tokensintegerOptional

Sum of prompt tokens.

total_completion_tokensintegerOptional

Sum of completion tokens.

total_tokensintegerOptional

Sum of all tokens.

error_countintegerOptional

Number of error spans.

namestringOptional

Root span name.

inputstringOptional

Root span input. API key responses may include full storage-enriched content.

outputstringOptional

Root span output. API key responses may include full storage-enriched content.

metadataobjectOptional

Customer metadata. Keys beginning with _ are reserved and omitted from customer-facing responses.

trace_group_identifierstringOptional

Workflow or trace-group identifier.

session_identifierstringOptional

Session identifier when present.

modelstringOptional

Primary/root model used.

storage_object_keystringOptional

Storage object key for the root span payload when present.

span_treelist of objectsOptional

Hierarchical span tree for the trace.

Errors

404

Not Found Error

429

Too Many Requests Error