---
title: "Get trace details."
method: GET
path: "/v1/tracing/traces/{traceId}"
tags: ["traces"]
---

# Get trace details.

`GET /v1/tracing/traces/{traceId}`

Get details of a trace with the given identifier.

## Path parameters

- `traceId` string, required

## Response `200`

Details of the trace with the given identifier.

- TraceDetail
  - `id` string, required — Trace identifier.
  - `rootService` string — Root service which started the trace. Examples: `user-service`, `authentication-service`, `payment-service`, `/shopping-cart`
  - `rootResource` string — Root resource on which the trace was started. Examples: `db.query`, `http.request`, `rpc.call`, `container`
  - `rootStatus` TraceSpanStatus
    - `code` string, required — Status code of the span. Possible values: `OK`, `ERROR`, `UNKNOWN`.
    - `message` string — Optional descriptive message about the status, could be an http status code or the kind of an error, e.g. OSError.
  - `rootOperationName` string — The name of the operation given to the root span.
  - `metrics` object — Calculated trace metrics.
  - `startedAt` string, date-time — Date and time the trace was started in [ISO 8601 / RFC3339](https://tools.ietf.org/html/rfc3339) format.
  - `criticalPathServiceBreakdownSummary` CriticalPathServiceBreakdownSummary
    - `elements` CriticalPathServiceBreakdownElementBase[], required — List of the elements representing the critical path service duration breakdown - contains the first few services with the longest overall duration of the spans contributing to the critical path.
      - `service` string — The name of the service.
      - `serviceColor` string — Color hex code assigned to the service.
      - `duration` integer, required — Overall processing time in nanoseconds consumed by the spans belonging to this service in the critical path (a sum of the duration times of the spans' critical path segments).
    - `otherServicesDuration` integer, required — Overall processing time in nanoseconds consumed by the rest of the spans in the critical path (a sum of the duration times of the spans' critical path segments).
    - `idleTime` integer, required — Overall time in nanoseconds when no particular operation was in progress.

## Other responses

- `default` — Operation failed with an error.

---

[API](https://skmtc.net/sumologic/apis/sumo-logic-api.md) · [All operations](https://skmtc.net/sumologic/apis/sumo-logic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sumologic/sumo-logic-api/revisions/18a824df1e78/schema)
