Skip to main content
GET /traces/{id} returns a single trace by its trace_id. LightShip evaluates the caller’s roles against the trace as a whole: if any span satisfies at least one of their policies, every span of the trace is returned. Otherwise the endpoint fails closed with 404.

​
Endpoint

Authentication: session cookie or Authorization: Bearer lsk_....

​
Path parameters

​
string
required
The trace_id of the trace to retrieve.

​
Query parameters

​
string
Comma-separated columns to project from the bound trace table, for example columns=TraceId,SpanId,Timestamp.

​
Response

​
string
The requested trace identifier.
​
object
The trace-table binding used to produce this response, so clients can find structural columns without knowing the customer’s schema.
​
array
Every span of the trace, in the projection LightShip returned.

​
Example

If the trace is unauthorized or not found, the endpoint returns 404 with {"error": "trace not found"}. It does not reveal whether the trace exists.