Fetch Trace

Fetch a single trace by trace_id.

Returns the trace as a traces map keyed by trace_id → span name. The response is empty when the trace is not in the current project. trace_id must be a 32-char hex UUID; any other format returns 400.

For flat-list retrieval across many traces, use POST /tracing/spans/query with focus="span".

get/tracing/traces/{trace_id}

Path parameters

trace_idstring required

Response

Successful Response

countinteger

Total number of matching traces or spans in the window.

tracesobject nullable

Nested tree of spans keyed by trace_id → span name, populated when the query was run with focus="trace" (default).

Changes

Changed in 9 of the 378 revisions of this API.8225

Aug 3, 2026fc532d6dc8209See the full diff
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property /////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////// to the response with the status
  response-optional-property-added
- ○
  added the optional property //////// to the response with the status
  response-optional-property-added
This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 19, 2026a7f9a68232302See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 8, 2026bb630edffa273See the full diff
- ○
  api tag Deprecated added
  api-tag-added
- ○
  api tag Traces removed
  api-tag-removed
- ○
  endpoint deprecated
  endpoint-deprecated
May 2, 20266e37373d45fe2See the full diff
- ○
  api tag Traces added
  api-tag-added
- ○
  api tag Observability removed
  api-tag-removed
This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 23, 2026925e8b901a262See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Mar 7, 202620311f76350585See the full diff
- ▲
  the response property ////// became optional for the status
  response-property-became-optional
- ▲
  the response property ////// became optional for the status
  response-property-became-optional
- ▲
  the response property /////////// became optional for the status
  response-property-became-optional
- ▲
  the response property /////////// became optional for the status
  response-property-became-optional
- ▲
  response property spans/anyOf[subschema #1]/items/links/anyOf[subschema #1]/items/span_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property spans/anyOf[subschema #1]/items/links/anyOf[subschema #1]/items/trace_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/links/anyOf[subschema #1]/items/span_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property traces/anyOf[subschema #1]/additionalProperties/spans/anyOf[subschema #1]/additionalProperties/anyOf[subschema #2]/items/links/anyOf[subschema #1]/items/trace_id list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  api operation id fetch_trace removed and replaced with fetch_trace_tracing
  api-operation-id-removed
- ○
  added to the ///// response property anyOf list for the response status
  response-property-any-of-added
- ○
  added to the ////////// response property anyOf list for the response status
  response-property-any-of-added
- ○
  removed from the ///// response property anyOf list for the response status
  response-property-any-of-removed
- ○
  removed from the ////////// response property anyOf list for the response status
  response-property-any-of-removed
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Feb 13, 202672fe88316d152See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
This revision also has 31 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 14, 202653da4c9de2b71See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 56 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 27, 2025e3e84db471981See the full diff
- ○
  api path removed with deprecation
  api-path-removed-with-deprecation
This revision also has 651 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history