---
title: "POST /Traces"
method: POST
path: "/Traces"
---

# POST /Traces

`POST /Traces`

Retrieves a list of traces specified by ID. Each trace is a collection of segment documents that originates from a single request. Use <code>GetTraceSummaries</code> to get a list of trace IDs.

## Query parameters

- `NextToken` string

## Request body

- object
  - `TraceIds` TraceId[], required — Specify the trace IDs of requests for which to retrieve segments.
  - `NextToken` string — Pagination token.

## Response `200`

Success

- BatchGetTracesResult
  - `Traces` Trace[] — Full traces for the specified requests.
    - `Id` string — The unique identifier for the request that generated the trace's segments and subsegments.
    - `Duration` number, double — The length of time in seconds between the start time of the root segment and the end time of the last segment that completed.
    - `LimitExceeded` boolean — LimitExceeded is set to true when the trace has exceeded the <code>Trace document size</code> limit. For more information about this limit and other X-Ray limits and quotas, see <a href="https://docs.aws.amazon.com/general/latest/gr/xray.html">Amazon Web Services X-Ray endpoints and quotas</a>.
    - `Segments` Segment[] — Segment documents for the segments and subsegments that comprise the trace.
      - `Id` string — The segment's ID.
      - `Document` string — The segment document.
  - `UnprocessedTraceIds` TraceId[] — Trace IDs of requests that haven't been processed.
  - `NextToken` string — Pagination token.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottledException

---

[API](https://skmtc.net/aws/apis/xray.md) · [All operations](https://skmtc.net/aws/apis/xray/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/xray/revisions/4970909a360e/schema)