Note : This endpoint is in preview and is subject to change.
If you have any feedback, contact Datadog support .
GET https://api.ap1.datadoghq.com/api/v2/trace/{trace_id} https://api.ap2.datadoghq.com/api/v2/trace/{trace_id} https://api.datadoghq.eu/api/v2/trace/{trace_id} https://api.ddog-gov.com/api/v2/trace/{trace_id} https://api.us2.ddog-gov.com/api/v2/trace/{trace_id} https://api.datadoghq.com/api/v2/trace/{trace_id} https://api.us3.datadoghq.com/api/v2/trace/{trace_id} https://api.us5.datadoghq.com/api/v2/trace/{trace_id}
Overview Retrieve a full APM trace by its trace ID, including every span in the trace.
Traces are returned from live storage when available and fall back to longer-term storage.
This endpoint is rate limited to 60 requests per minute per organization.
This endpoint requires the apm_read permission.
OAuth apps require the apm_read authorization scope to access this endpoint.
Arguments Path Parameters The trace ID. Accepts either a 32-character hexadecimal string (128-bit trace ID)
or a decimal string of up to 39 digits.
Query Strings List of span fields to include in the response. When omitted, every available field is returned.
Values may be passed as repeated query parameters or as a single comma-separated value.
Response OK
Response containing a single trace.
Expand All
A trace resource document.
The attributes of a trace returned by the Get trace by ID endpoint.
Indicates whether the trace was truncated because its size exceeded the maximum response payload.
The list of spans that compose the trace.
The duration of the span, in nanoseconds.
The end time of the span, in Unix nanoseconds.
Error flag for a span. 1 when the span is in error, 0 otherwise.
Allowed enum values: 0,1
String-valued tags attached to the span. Tag keys starting with _ are
filtered out of the response.
Numeric metrics attached to the span. Metric keys starting with _ are
filtered out of the response.
The operation name of the span.
The ID of the parent span, or 0 when the span is a trace root.
The resource that the span describes.
A hash of the resource field.
Whether access to the span is restricted by the organization's data access policies.
The time spent in the span itself, excluding time spent in child spans, in nanoseconds.
The name of the service that emitted the span.
The span ID, as an unsigned 64-bit integer.
The start time of the span, in Unix nanoseconds.
The lower 64 bits of the trace ID, as an unsigned 64-bit integer.
The full 128-bit trace ID, encoded as a 32-character hexadecimal string.
The type of the span (for example, web, db, or rpc).
The full 128-bit trace ID, encoded as a 32-character hexadecimal string.
The type of the trace resource. The value is always trace.
Allowed enum values: trace
{
"data" : {
"attributes" : {
"is_truncated" : false ,
"spans" : [
{
"duration" : 500000000 ,
"endTime" : 1716800000500000000 ,
"error" : 0 ,
"meta" : {
"<any-key>" : "string"
},
"metrics" : {
"<any-key>" : "number"
},
"name" : "web.request" ,
"parentID" : 0 ,
"resource" : "GET /products" ,
"resourceHash" : "6a4e9b7f" ,
"restricted" : false ,
"self_time" : 250000000 ,
"service" : "web-store" ,
"spanID" : 9876543210987655000 ,
"startTime" : 1716800000000000000 ,
"traceID" : 12345678901234567000 ,
"traceIDFull" : "0000000000000000abc1230000000000" ,
"type" : "web"
}
]
},
"id" : "0000000000000000abc1230000000000" ,
"type" : "trace"
}
} Forbidden
API error response.
Expand All
A human-readable explanation specific to this occurrence of the error.
Non-standard meta-information about the error
References to the source of the error.
A string indicating the name of a single request header which caused the error.
A string indicating which URI query parameter caused the error.
A JSON pointer to the value in the request document that caused the error.
Status code of the response.
Short human-readable summary of the error.
{
"errors" : [
{
"detail" : "Missing required attribute in body" ,
"meta" : {},
"source" : {
"header" : "Authorization" ,
"parameter" : "limit" ,
"pointer" : "/data/attributes/title"
},
"status" : "400" ,
"title" : "Bad Request"
}
]
} Not Found
API error response.
Expand All
A human-readable explanation specific to this occurrence of the error.
Non-standard meta-information about the error
References to the source of the error.
A string indicating the name of a single request header which caused the error.
A string indicating which URI query parameter caused the error.
A JSON pointer to the value in the request document that caused the error.
Status code of the response.
Short human-readable summary of the error.
{
"errors" : [
{
"detail" : "Missing required attribute in body" ,
"meta" : {},
"source" : {
"header" : "Authorization" ,
"parameter" : "limit" ,
"pointer" : "/data/attributes/title"
},
"status" : "400" ,
"title" : "Bad Request"
}
]
} Payload Too Large
API error response.
Expand All
A human-readable explanation specific to this occurrence of the error.
Non-standard meta-information about the error
References to the source of the error.
A string indicating the name of a single request header which caused the error.
A string indicating which URI query parameter caused the error.
A JSON pointer to the value in the request document that caused the error.
Status code of the response.
Short human-readable summary of the error.
{
"errors" : [
{
"detail" : "Missing required attribute in body" ,
"meta" : {},
"source" : {
"header" : "Authorization" ,
"parameter" : "limit" ,
"pointer" : "/data/attributes/title"
},
"status" : "400" ,
"title" : "Bad Request"
}
]
} Too many requests
{
"errors" : [
"Bad Request"
]
} Code Example Copy
# Path parameters export trace_id = "0000000000000000abc1230000000000" # Curl command curl -X GET "https://api.ap1.datadoghq.com "https://api.ap2.datadoghq.com "https://api.datadoghq.eu "https://api.ddog-gov.com "https://api.us2.ddog-gov.com "https://api.datadoghq.com "https://api.us3.datadoghq.com "https://api.us5.datadoghq.com /api/v2/trace/${trace_id} " \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY} " \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY} " 
