Amazon X-Ray
AWS X-Ray is a distributed tracing service that helps developers analyze and debug production applications, providing end-to-end visibility into requests as they travel through the application. X-Ray provides service maps, trace analysis, sampling rules, group filtering, and AI-powered insights for identifying performance bottlenecks and errors across microservices and serverless architectures.
Amazon X-Ray publishes 32 APIs on the APIs.io network, including CreateGroup API, CreateSamplingRule API, DeleteGroup API, and 29 more. Tagged areas include Application Performance, Debugging, Distributed Tracing, Monitoring, and Observability.
The Amazon X-Ray catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Amazon X-Ray’s developer surface includes authentication, developer portal, documentation, support, engineering blog, developer console, signup flow, and 17 more developer resources.
Kin Score
Kin Score
How this is scored →scored 2026-07-28 · rubric v0.6
APIs 32
Individual APIs this provider publishes, each with its own machine-readable definition.
Amazon X-Ray CreateGroup API
The CreateGroup API from Amazon X-Ray — 1 operation(s) for creategroup.
Amazon X-Ray CreateSamplingRule API
The CreateSamplingRule API from Amazon X-Ray — 1 operation(s) for createsamplingrule.
Amazon X-Ray DeleteGroup API
The DeleteGroup API from Amazon X-Ray — 1 operation(s) for deletegroup.
Amazon X-Ray DeleteResourcePolicy API
The DeleteResourcePolicy API from Amazon X-Ray — 1 operation(s) for deleteresourcepolicy.
Amazon X-Ray DeleteSamplingRule API
The DeleteSamplingRule API from Amazon X-Ray — 1 operation(s) for deletesamplingrule.
Amazon X-Ray EncryptionConfig API
The EncryptionConfig API from Amazon X-Ray — 1 operation(s) for encryptionconfig.
Amazon X-Ray GetGroup API
The GetGroup API from Amazon X-Ray — 1 operation(s) for getgroup.
Amazon X-Ray GetSamplingRules API
The GetSamplingRules API from Amazon X-Ray — 1 operation(s) for getsamplingrules.
Amazon X-Ray Groups API
The Groups API from Amazon X-Ray — 1 operation(s) for groups.
Amazon X-Ray Insight API
The Insight API from Amazon X-Ray — 1 operation(s) for insight.
Amazon X-Ray InsightEvents API
The InsightEvents API from Amazon X-Ray — 1 operation(s) for insightevents.
Amazon X-Ray InsightImpactGraph API
The InsightImpactGraph API from Amazon X-Ray — 1 operation(s) for insightimpactgraph.
Amazon X-Ray InsightSummaries API
The InsightSummaries API from Amazon X-Ray — 1 operation(s) for insightsummaries.
Amazon X-Ray ListResourcePolicies API
The ListResourcePolicies API from Amazon X-Ray — 1 operation(s) for listresourcepolicies.
Amazon X-Ray ListTagsForResource API
The ListTagsForResource API from Amazon X-Ray — 1 operation(s) for listtagsforresource.
Amazon X-Ray PutEncryptionConfig API
The PutEncryptionConfig API from Amazon X-Ray — 1 operation(s) for putencryptionconfig.
Amazon X-Ray PutResourcePolicy API
The PutResourcePolicy API from Amazon X-Ray — 1 operation(s) for putresourcepolicy.
Amazon X-Ray Sampling API
The Sampling API from Amazon X-Ray — 1 operation(s) for sampling.
Amazon X-Ray SamplingStatisticSummaries API
The SamplingStatisticSummaries API from Amazon X-Ray — 1 operation(s) for samplingstatisticsummaries.
Amazon X-Ray SamplingTargets API
The SamplingTargets API from Amazon X-Ray — 1 operation(s) for samplingtargets.
Amazon X-Ray Service Graph API
The Service Graph API from Amazon X-Ray — 1 operation(s) for service graph.
Amazon X-Ray ServiceGraph API
The ServiceGraph API from Amazon X-Ray — 1 operation(s) for servicegraph.
Amazon X-Ray TagResource API
The TagResource API from Amazon X-Ray — 1 operation(s) for tagresource.
Amazon X-Ray TelemetryRecords API
The TelemetryRecords API from Amazon X-Ray — 1 operation(s) for telemetryrecords.
Amazon X-Ray TimeSeriesServiceStatistics API
The TimeSeriesServiceStatistics API from Amazon X-Ray — 1 operation(s) for timeseriesservicestatistics.
Amazon X-Ray TraceGraph API
The TraceGraph API from Amazon X-Ray — 1 operation(s) for tracegraph.
Amazon X-Ray Traces API
The Traces API from Amazon X-Ray — 2 operation(s) for traces.
Amazon X-Ray TraceSegments API
The TraceSegments API from Amazon X-Ray — 1 operation(s) for tracesegments.
Amazon X-Ray TraceSummaries API
The TraceSummaries API from Amazon X-Ray — 1 operation(s) for tracesummaries.
Amazon X-Ray UntagResource API
The UntagResource API from Amazon X-Ray — 1 operation(s) for untagresource.
Amazon X-Ray UpdateGroup API
The UpdateGroup API from Amazon X-Ray — 1 operation(s) for updategroup.
Amazon X-Ray UpdateSamplingRule API
The UpdateSamplingRule API from Amazon X-Ray — 1 operation(s) for updatesamplingrule.
Scroll for all 32
Postman Collections 32
Ready-to-run Postman collections for exercising this provider's APIs.
AWS X-Ray CreateGroup API
POSTMANScroll for all 32
Open Collections 1
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Amazon X-Ray API
OPEN COLLECTIONPricing Plans 1
Published pricing tiers and plan structures.
Rate Limits 1
Documented rate limits and quota policies.
Amazon Xray Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals for API financial operations.
Amazon Xray Finops
FINOPSFeatures 8
Notable capabilities this provider offers.
End-to-End Distributed Tracing
Trace requests as they travel across services, microservices, and serverless functions to identify bottlenecks and errors.
Service Map Visualization
Automatically generate visual service maps showing all connected services and their health status and latency.
Trace Filtering and Groups
Create groups with filter expressions to organize and analyze subsets of traces based on service names, URLs, or annotations.
Adaptive Sampling
Configurable sampling rules to control the percentage of requests traced, balancing coverage with cost.
X-Ray Insights
AI-powered automatic detection of anomalies and performance issues with root cause analysis across the service map.
AWS Service Integration
Native tracing support across Lambda, EC2, ECS, EKS, API Gateway, SNS, SQS, and 200+ other AWS services.
SDK and Agent Support
X-Ray SDKs for Java, Node.js, Python, Go, Ruby, and .NET for custom application instrumentation.
CloudWatch Integration
Deep integration with Amazon CloudWatch for correlating traces with metrics, logs, and alarms.
Scroll for all 8
Semantic Vocabularies 1
JSON-LD contexts and semantic vocabularies used across these APIs.
Amazon Xray Context
JSON-LDSpectral Rules 2
Spectral governance rulesets for linting and validating these APIs.
Amazon X-Ray API Rules
SPECTRALAmazon X-Ray API Rules
SPECTRALJSON Schema 233
Standalone JSON Schema definitions for this provider's data models.
AWS X-Ray Trace
JSON SCHEMAAliasList
JSON SCHEMAAliasNames
JSON SCHEMAAlias
JSON SCHEMAAmazonResourceName
JSON SCHEMAAnnotationKey
JSON SCHEMAAnnotationValue
JSON SCHEMAAnnotations
JSON SCHEMAAnomalousServiceList
JSON SCHEMAAnomalousService
JSON SCHEMAAttributeKey
JSON SCHEMAAttributeMap
JSON SCHEMAAttributeValue
JSON SCHEMAAvailabilityZoneDetail
JSON SCHEMABackendConnectionErrors
JSON SCHEMABatchGetTracesRequest
JSON SCHEMABatchGetTracesResult
JSON SCHEMABoolean
JSON SCHEMABorrowCount
JSON SCHEMAClientID
JSON SCHEMACreateGroupRequest
JSON SCHEMACreateGroupResult
JSON SCHEMACreateSamplingRuleRequest
JSON SCHEMACreateSamplingRuleResult
JSON SCHEMADeleteGroupRequest
JSON SCHEMADeleteGroupResult
JSON SCHEMADeleteResourcePolicyRequest
JSON SCHEMADeleteResourcePolicyResult
JSON SCHEMADeleteSamplingRuleRequest
JSON SCHEMADeleteSamplingRuleResult
JSON SCHEMADouble
JSON SCHEMAEC2InstanceId
JSON SCHEMAEdgeList
JSON SCHEMAEdge
JSON SCHEMAEdgeStatistics
JSON SCHEMAEncryptionConfig
JSON SCHEMAEncryptionKeyId
JSON SCHEMAEncryptionStatus
JSON SCHEMAEncryptionType
JSON SCHEMAEntitySelectorExpression
JSON SCHEMAErrorRootCauseEntityPath
JSON SCHEMAErrorRootCauseEntity
JSON SCHEMAErrorRootCause
JSON SCHEMAErrorRootCauseService
JSON SCHEMAErrorRootCauseServices
JSON SCHEMAErrorRootCauses
JSON SCHEMAErrorStatistics
JSON SCHEMAEventSummaryText
JSON SCHEMAFaultRootCauseEntityPath
JSON SCHEMAFaultRootCauseEntity
JSON SCHEMAFaultRootCause
JSON SCHEMAFaultRootCauseService
JSON SCHEMAFaultRootCauseServices
JSON SCHEMAFaultRootCauses
JSON SCHEMAFaultStatistics
JSON SCHEMAFilterExpression
JSON SCHEMAFixedRate
JSON SCHEMAForecastStatistics
JSON SCHEMAGetEncryptionConfigRequest
JSON SCHEMAGetEncryptionConfigResult
JSON SCHEMAGetGroupRequest
JSON SCHEMAGetGroupResult
JSON SCHEMAGetGroupsNextToken
JSON SCHEMAGetGroupsRequest
JSON SCHEMAGetGroupsResult
JSON SCHEMAGetInsightEventsMaxResults
JSON SCHEMAGetInsightEventsRequest
JSON SCHEMAGetInsightEventsResult
JSON SCHEMAGetInsightImpactGraphRequest
JSON SCHEMAGetInsightImpactGraphResult
JSON SCHEMAGetInsightRequest
JSON SCHEMAGetInsightResult
JSON SCHEMAGetInsightSummariesMaxResults
JSON SCHEMAGetInsightSummariesRequest
JSON SCHEMAGetInsightSummariesResult
JSON SCHEMAGetSamplingRulesRequest
JSON SCHEMAGetSamplingRulesResult
JSON SCHEMAGetSamplingStatisticSummariesRequest
JSON SCHEMAGetSamplingStatisticSummariesResult
JSON SCHEMAGetSamplingTargetsRequest
JSON SCHEMAGetSamplingTargetsResult
JSON SCHEMAGetServiceGraphRequest
JSON SCHEMAGetServiceGraphResult
JSON SCHEMAGetTimeSeriesServiceStatisticsRequest
JSON SCHEMAGetTimeSeriesServiceStatisticsResult
JSON SCHEMAGetTraceGraphRequest
JSON SCHEMAGetTraceGraphResult
JSON SCHEMAGetTraceSummariesRequest
JSON SCHEMAGetTraceSummariesResult
JSON SCHEMAGroupARN
JSON SCHEMAGroupName
JSON SCHEMAGroup
JSON SCHEMAGroupSummaryList
JSON SCHEMAGroupSummary
JSON SCHEMAHistogramEntry
JSON SCHEMAHistogram
JSON SCHEMAHost
JSON SCHEMAHostname
JSON SCHEMAHTTPMethod
JSON SCHEMAHttp
JSON SCHEMAInsightCategoryList
JSON SCHEMAInsightCategory
JSON SCHEMAInsightEventList
JSON SCHEMAInsightEvent
JSON SCHEMAInsightId
JSON SCHEMAInsightImpactGraphEdgeList
JSON SCHEMAInsightImpactGraphEdge
JSON SCHEMAInsightImpactGraphServiceList
JSON SCHEMAInsightImpactGraphService
JSON SCHEMAInsight
JSON SCHEMAInsightStateList
JSON SCHEMAInsightState
JSON SCHEMAInsightSummaryList
JSON SCHEMAInsightSummary
JSON SCHEMAInsightSummaryText
JSON SCHEMAInsightsConfiguration
JSON SCHEMAInstanceIdDetail
JSON SCHEMAInteger
JSON SCHEMAInvalidPolicyRevisionIdException
JSON SCHEMAInvalidRequestException
JSON SCHEMAListResourcePoliciesRequest
JSON SCHEMAListResourcePoliciesResult
JSON SCHEMAListTagsForResourceRequest
JSON SCHEMAListTagsForResourceResponse
JSON SCHEMALockoutPreventionException
JSON SCHEMAMalformedPolicyDocumentException
JSON SCHEMANullableBoolean
JSON SCHEMANullableDouble
JSON SCHEMANullableInteger
JSON SCHEMANullableLong
JSON SCHEMAPolicyCountLimitExceededException
JSON SCHEMAPolicyDocument
JSON SCHEMAPolicyName
JSON SCHEMAPolicyRevisionId
JSON SCHEMAPolicySizeLimitExceededException
JSON SCHEMAPriority
JSON SCHEMAPutEncryptionConfigRequest
JSON SCHEMAPutEncryptionConfigResult
JSON SCHEMAPutResourcePolicyRequest
JSON SCHEMAPutResourcePolicyResult
JSON SCHEMAPutTelemetryRecordsRequest
JSON SCHEMAPutTelemetryRecordsResult
JSON SCHEMAPutTraceSegmentsRequest
JSON SCHEMAPutTraceSegmentsResult
JSON SCHEMARequestCount
JSON SCHEMARequestImpactStatistics
JSON SCHEMAReservoirSize
JSON SCHEMAResourceARNDetail
JSON SCHEMAResourceARN
JSON SCHEMAResourceNotFoundException
JSON SCHEMAResourcePolicyList
JSON SCHEMAResourcePolicyNextToken
JSON SCHEMAResourcePolicy
JSON SCHEMAResponseTimeRootCauseEntityPath
JSON SCHEMAResponseTimeRootCauseEntity
JSON SCHEMAResponseTimeRootCause
JSON SCHEMAResponseTimeRootCauseService
JSON SCHEMAResponseTimeRootCauseServices
JSON SCHEMAResponseTimeRootCauses
JSON SCHEMARootCauseException
JSON SCHEMARootCauseExceptions
JSON SCHEMARuleLimitExceededException
JSON SCHEMARuleName
JSON SCHEMASampledCount
JSON SCHEMASamplingRuleRecordList
JSON SCHEMASamplingRuleRecord
JSON SCHEMASamplingRule
JSON SCHEMASamplingRuleUpdate
JSON SCHEMASamplingStatisticSummaryList
JSON SCHEMASamplingStatisticSummary
JSON SCHEMASamplingStatisticsDocumentList
JSON SCHEMASamplingStatisticsDocument
JSON SCHEMASamplingStrategyName
JSON SCHEMASamplingStrategy
JSON SCHEMASamplingTargetDocumentList
JSON SCHEMASamplingTargetDocument
JSON SCHEMASegmentDocument
JSON SCHEMASegmentId
JSON SCHEMASegmentList
JSON SCHEMASegment
JSON SCHEMAServiceId
JSON SCHEMAServiceIds
JSON SCHEMAServiceList
JSON SCHEMAServiceName
JSON SCHEMAServiceNames
JSON SCHEMAService
JSON SCHEMAServiceStatistics
JSON SCHEMAServiceType
JSON SCHEMAString
JSON SCHEMATagKeyList
JSON SCHEMATagKey
JSON SCHEMATagList
JSON SCHEMATagResourceRequest
JSON SCHEMATagResourceResponse
JSON SCHEMATag
JSON SCHEMATagValue
JSON SCHEMATelemetryRecordList
JSON SCHEMATelemetryRecord
JSON SCHEMAThrottledException
JSON SCHEMATimeRangeType
JSON SCHEMATimeSeriesServiceStatisticsList
JSON SCHEMATimeSeriesServiceStatistics
JSON SCHEMATimestamp
JSON SCHEMAToken
JSON SCHEMATooManyTagsException
JSON SCHEMATraceAvailabilityZones
JSON SCHEMATraceIdList
JSON SCHEMATraceId
JSON SCHEMATraceInstanceIds
JSON SCHEMATraceList
JSON SCHEMATraceResourceARNs
JSON SCHEMATrace
JSON SCHEMATraceSegmentDocumentList
JSON SCHEMATraceSegmentDocument
JSON SCHEMATraceSummaryList
JSON SCHEMATraceSummary
JSON SCHEMATraceUser
JSON SCHEMATraceUsers
JSON SCHEMAUnprocessedStatisticsList
JSON SCHEMAUnprocessedStatistics
JSON SCHEMAUnprocessedTraceIdList
JSON SCHEMAUnprocessedTraceSegmentList
JSON SCHEMAUnprocessedTraceSegment
JSON SCHEMAUntagResourceRequest
JSON SCHEMAUntagResourceResponse
JSON SCHEMAUpdateGroupRequest
JSON SCHEMAUpdateGroupResult
JSON SCHEMAUpdateSamplingRuleRequest
JSON SCHEMAUpdateSamplingRuleResult
JSON SCHEMAURLPath
JSON SCHEMAValueWithServiceIds
JSON SCHEMAValuesWithServiceIds
JSON SCHEMAVersion
JSON SCHEMAScroll for all 233
JSON Structure 232
JSON Structure definitions describing this provider's data shapes.
Xray Alias List Structure
JSON STRUCTUREXray Alias Names Structure
JSON STRUCTUREXray Alias Structure
JSON STRUCTUREXray Amazon Resource Name Structure
JSON STRUCTUREXray Annotation Key Structure
JSON STRUCTUREXray Annotation Value Structure
JSON STRUCTUREXray Annotations Structure
JSON STRUCTUREXray Anomalous Service List Structure
JSON STRUCTUREXray Anomalous Service Structure
JSON STRUCTUREXray Attribute Key Structure
JSON STRUCTUREXray Attribute Map Structure
JSON STRUCTUREXray Attribute Value Structure
JSON STRUCTUREXray Availability Zone Detail Structure
JSON STRUCTUREXray Backend Connection Errors Structure
JSON STRUCTUREXray Batch Get Traces Request Structure
JSON STRUCTUREXray Batch Get Traces Result Structure
JSON STRUCTUREXray Boolean Structure
JSON STRUCTUREXray Borrow Count Structure
JSON STRUCTUREXray Client Id Structure
JSON STRUCTUREXray Create Group Request Structure
JSON STRUCTUREXray Create Group Result Structure
JSON STRUCTUREXray Create Sampling Rule Request Structure
JSON STRUCTUREXray Create Sampling Rule Result Structure
JSON STRUCTUREXray Delete Group Request Structure
JSON STRUCTUREXray Delete Group Result Structure
JSON STRUCTUREXray Delete Resource Policy Request Structure
JSON STRUCTUREXray Delete Resource Policy Result Structure
JSON STRUCTUREXray Delete Sampling Rule Request Structure
JSON STRUCTUREXray Delete Sampling Rule Result Structure
JSON STRUCTUREXray Double Structure
JSON STRUCTUREXray Ec2 Instance Id Structure
JSON STRUCTUREXray Edge List Structure
JSON STRUCTUREXray Edge Statistics Structure
JSON STRUCTUREXray Edge Structure
JSON STRUCTUREXray Encryption Config Structure
JSON STRUCTUREXray Encryption Key Id Structure
JSON STRUCTUREXray Encryption Status Structure
JSON STRUCTUREXray Encryption Type Structure
JSON STRUCTUREXray Entity Selector Expression Structure
JSON STRUCTUREXray Error Root Cause Entity Path Structure
JSON STRUCTUREXray Error Root Cause Entity Structure
JSON STRUCTUREXray Error Root Cause Service Structure
JSON STRUCTUREXray Error Root Cause Services Structure
JSON STRUCTUREXray Error Root Cause Structure
JSON STRUCTUREXray Error Root Causes Structure
JSON STRUCTUREXray Error Statistics Structure
JSON STRUCTUREXray Event Summary Text Structure
JSON STRUCTUREXray Fault Root Cause Entity Path Structure
JSON STRUCTUREXray Fault Root Cause Entity Structure
JSON STRUCTUREXray Fault Root Cause Service Structure
JSON STRUCTUREXray Fault Root Cause Services Structure
JSON STRUCTUREXray Fault Root Cause Structure
JSON STRUCTUREXray Fault Root Causes Structure
JSON STRUCTUREXray Fault Statistics Structure
JSON STRUCTUREXray Filter Expression Structure
JSON STRUCTUREXray Fixed Rate Structure
JSON STRUCTUREXray Forecast Statistics Structure
JSON STRUCTUREXray Get Encryption Config Request Structure
JSON STRUCTUREXray Get Encryption Config Result Structure
JSON STRUCTUREXray Get Group Request Structure
JSON STRUCTUREXray Get Group Result Structure
JSON STRUCTUREXray Get Groups Next Token Structure
JSON STRUCTUREXray Get Groups Request Structure
JSON STRUCTUREXray Get Groups Result Structure
JSON STRUCTUREXray Get Insight Events Max Results Structure
JSON STRUCTUREXray Get Insight Events Request Structure
JSON STRUCTUREXray Get Insight Events Result Structure
JSON STRUCTUREXray Get Insight Impact Graph Request Structure
JSON STRUCTUREXray Get Insight Impact Graph Result Structure
JSON STRUCTUREXray Get Insight Request Structure
JSON STRUCTUREXray Get Insight Result Structure
JSON STRUCTUREXray Get Insight Summaries Max Results Structure
JSON STRUCTUREXray Get Insight Summaries Request Structure
JSON STRUCTUREXray Get Insight Summaries Result Structure
JSON STRUCTUREXray Get Sampling Rules Request Structure
JSON STRUCTUREXray Get Sampling Rules Result Structure
JSON STRUCTUREXray Get Sampling Statistic Summaries Request Structure
JSON STRUCTUREXray Get Sampling Statistic Summaries Result Structure
JSON STRUCTUREXray Get Sampling Targets Request Structure
JSON STRUCTUREXray Get Sampling Targets Result Structure
JSON STRUCTUREXray Get Service Graph Request Structure
JSON STRUCTUREXray Get Service Graph Result Structure
JSON STRUCTUREXray Get Time Series Service Statistics Result Structure
JSON STRUCTUREXray Get Trace Graph Request Structure
JSON STRUCTUREXray Get Trace Graph Result Structure
JSON STRUCTUREXray Get Trace Summaries Request Structure
JSON STRUCTUREXray Get Trace Summaries Result Structure
JSON STRUCTUREXray Group Arn Structure
JSON STRUCTUREXray Group Name Structure
JSON STRUCTUREXray Group Structure
JSON STRUCTUREXray Group Summary List Structure
JSON STRUCTUREXray Group Summary Structure
JSON STRUCTUREXray Histogram Entry Structure
JSON STRUCTUREXray Histogram Structure
JSON STRUCTUREXray Host Structure
JSON STRUCTUREXray Hostname Structure
JSON STRUCTUREXray Http Method Structure
JSON STRUCTUREXray Http Structure
JSON STRUCTUREXray Insight Category List Structure
JSON STRUCTUREXray Insight Category Structure
JSON STRUCTUREXray Insight Event List Structure
JSON STRUCTUREXray Insight Event Structure
JSON STRUCTUREXray Insight Id Structure
JSON STRUCTUREXray Insight Impact Graph Edge List Structure
JSON STRUCTUREXray Insight Impact Graph Edge Structure
JSON STRUCTUREXray Insight Impact Graph Service List Structure
JSON STRUCTUREXray Insight Impact Graph Service Structure
JSON STRUCTUREXray Insight State List Structure
JSON STRUCTUREXray Insight State Structure
JSON STRUCTUREXray Insight Structure
JSON STRUCTUREXray Insight Summary List Structure
JSON STRUCTUREXray Insight Summary Structure
JSON STRUCTUREXray Insight Summary Text Structure
JSON STRUCTUREXray Insights Configuration Structure
JSON STRUCTUREXray Instance Id Detail Structure
JSON STRUCTUREXray Integer Structure
JSON STRUCTUREXray Invalid Policy Revision Id Exception Structure
JSON STRUCTUREXray Invalid Request Exception Structure
JSON STRUCTUREXray List Resource Policies Request Structure
JSON STRUCTUREXray List Resource Policies Result Structure
JSON STRUCTUREXray List Tags For Resource Request Structure
JSON STRUCTUREXray List Tags For Resource Response Structure
JSON STRUCTUREXray Lockout Prevention Exception Structure
JSON STRUCTUREXray Malformed Policy Document Exception Structure
JSON STRUCTUREXray Nullable Boolean Structure
JSON STRUCTUREXray Nullable Double Structure
JSON STRUCTUREXray Nullable Integer Structure
JSON STRUCTUREXray Nullable Long Structure
JSON STRUCTUREXray Policy Count Limit Exceeded Exception Structure
JSON STRUCTUREXray Policy Document Structure
JSON STRUCTUREXray Policy Name Structure
JSON STRUCTUREXray Policy Revision Id Structure
JSON STRUCTUREXray Policy Size Limit Exceeded Exception Structure
JSON STRUCTUREXray Priority Structure
JSON STRUCTUREXray Put Encryption Config Request Structure
JSON STRUCTUREXray Put Encryption Config Result Structure
JSON STRUCTUREXray Put Resource Policy Request Structure
JSON STRUCTUREXray Put Resource Policy Result Structure
JSON STRUCTUREXray Put Telemetry Records Request Structure
JSON STRUCTUREXray Put Telemetry Records Result Structure
JSON STRUCTUREXray Put Trace Segments Request Structure
JSON STRUCTUREXray Put Trace Segments Result Structure
JSON STRUCTUREXray Request Count Structure
JSON STRUCTUREXray Request Impact Statistics Structure
JSON STRUCTUREXray Reservoir Size Structure
JSON STRUCTUREXray Resource Arn Detail Structure
JSON STRUCTUREXray Resource Arn Structure
JSON STRUCTUREXray Resource Not Found Exception Structure
JSON STRUCTUREXray Resource Policy List Structure
JSON STRUCTUREXray Resource Policy Next Token Structure
JSON STRUCTUREXray Resource Policy Structure
JSON STRUCTUREXray Response Time Root Cause Entity Path Structure
JSON STRUCTUREXray Response Time Root Cause Entity Structure
JSON STRUCTUREXray Response Time Root Cause Service Structure
JSON STRUCTUREXray Response Time Root Cause Services Structure
JSON STRUCTUREXray Response Time Root Cause Structure
JSON STRUCTUREXray Response Time Root Causes Structure
JSON STRUCTUREXray Root Cause Exception Structure
JSON STRUCTUREXray Root Cause Exceptions Structure
JSON STRUCTUREXray Rule Limit Exceeded Exception Structure
JSON STRUCTUREXray Rule Name Structure
JSON STRUCTUREXray Sampled Count Structure
JSON STRUCTUREXray Sampling Rule Record List Structure
JSON STRUCTUREXray Sampling Rule Record Structure
JSON STRUCTUREXray Sampling Rule Structure
JSON STRUCTUREXray Sampling Rule Update Structure
JSON STRUCTUREXray Sampling Statistic Summary List Structure
JSON STRUCTUREXray Sampling Statistic Summary Structure
JSON STRUCTUREXray Sampling Statistics Document List Structure
JSON STRUCTUREXray Sampling Statistics Document Structure
JSON STRUCTUREXray Sampling Strategy Name Structure
JSON STRUCTUREXray Sampling Strategy Structure
JSON STRUCTUREXray Sampling Target Document List Structure
JSON STRUCTUREXray Sampling Target Document Structure
JSON STRUCTUREXray Segment Document Structure
JSON STRUCTUREXray Segment Id Structure
JSON STRUCTUREXray Segment List Structure
JSON STRUCTUREXray Segment Structure
JSON STRUCTUREXray Service Id Structure
JSON STRUCTUREXray Service Ids Structure
JSON STRUCTUREXray Service List Structure
JSON STRUCTUREXray Service Name Structure
JSON STRUCTUREXray Service Names Structure
JSON STRUCTUREXray Service Statistics Structure
JSON STRUCTUREXray Service Structure
JSON STRUCTUREXray Service Type Structure
JSON STRUCTUREXray String Structure
JSON STRUCTUREXray Tag Key List Structure
JSON STRUCTUREXray Tag Key Structure
JSON STRUCTUREXray Tag List Structure
JSON STRUCTUREXray Tag Resource Request Structure
JSON STRUCTUREXray Tag Resource Response Structure
JSON STRUCTUREXray Tag Structure
JSON STRUCTUREXray Tag Value Structure
JSON STRUCTUREXray Telemetry Record List Structure
JSON STRUCTUREXray Telemetry Record Structure
JSON STRUCTUREXray Throttled Exception Structure
JSON STRUCTUREXray Time Range Type Structure
JSON STRUCTUREXray Time Series Service Statistics List Structure
JSON STRUCTUREXray Time Series Service Statistics Structure
JSON STRUCTUREXray Timestamp Structure
JSON STRUCTUREXray Token Structure
JSON STRUCTUREXray Too Many Tags Exception Structure
JSON STRUCTUREXray Trace Availability Zones Structure
JSON STRUCTUREXray Trace Id List Structure
JSON STRUCTUREXray Trace Id Structure
JSON STRUCTUREXray Trace Instance Ids Structure
JSON STRUCTUREXray Trace List Structure
JSON STRUCTUREXray Trace Resource Ar Ns Structure
JSON STRUCTUREXray Trace Segment Document List Structure
JSON STRUCTUREXray Trace Segment Document Structure
JSON STRUCTUREXray Trace Structure
JSON STRUCTUREXray Trace Summary List Structure
JSON STRUCTUREXray Trace Summary Structure
JSON STRUCTUREXray Trace User Structure
JSON STRUCTUREXray Trace Users Structure
JSON STRUCTUREXray Unprocessed Statistics List Structure
JSON STRUCTUREXray Unprocessed Statistics Structure
JSON STRUCTUREXray Unprocessed Trace Id List Structure
JSON STRUCTUREXray Unprocessed Trace Segment List Structure
JSON STRUCTUREXray Unprocessed Trace Segment Structure
JSON STRUCTUREXray Untag Resource Request Structure
JSON STRUCTUREXray Untag Resource Response Structure
JSON STRUCTUREXray Update Group Request Structure
JSON STRUCTUREXray Update Group Result Structure
JSON STRUCTUREXray Update Sampling Rule Request Structure
JSON STRUCTUREXray Update Sampling Rule Result Structure
JSON STRUCTUREXray Url Path Structure
JSON STRUCTUREXray Value With Service Ids Structure
JSON STRUCTUREXray Values With Service Ids Structure
JSON STRUCTUREXray Version Structure
JSON STRUCTUREScroll for all 232
Examples 109
Example request and response payloads for these APIs.
Xray Alias Example
EXAMPLEXray Edge Example
EXAMPLEXray Edge Statistics Example
EXAMPLEXray Group Example
EXAMPLEXray Group Summary Example
EXAMPLEXray Histogram Entry Example
EXAMPLEXray Http Example
EXAMPLEXray Insight Event Example
EXAMPLEXray Insight Example
EXAMPLEXray Insight Summary Example
EXAMPLEXray Resource Policy Example
EXAMPLEXray Sampling Rule Example
EXAMPLEXray Segment Example
EXAMPLEXray Service Example
EXAMPLEXray Service Id Example
EXAMPLEXray Tag Example
EXAMPLEXray Trace Example
EXAMPLEXray Trace Summary Example
EXAMPLEXray Trace User Example
EXAMPLEScroll for all 109
Security Posture 4
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Agentic Access 1
Recommended x-agentic-access execution contracts for AI agents.
Use Cases 5
What developers build with this provider.
Microservices Debugging
Trace requests across microservices to identify which service is causing latency or errors in distributed applications.
Serverless Application Monitoring
Monitor Lambda function execution chains and identify cold start impacts and downstream service bottlenecks.
Performance Optimization
Use trace data and service maps to identify and eliminate performance bottlenecks in production applications.
Root Cause Analysis
Drill into traces to understand the exact call chain that caused an error or latency spike.
SLA Compliance Monitoring
Track end-to-end latency and error rates across services to ensure application SLAs are being met.
Integrations 5
Pre-built integrations with other platforms and tools.
AWS Lambda
Automatic tracing of Lambda function invocations and downstream calls.
Amazon API Gateway
Native tracing of API Gateway requests through backend services.
Amazon CloudWatch
Correlation of traces with CloudWatch metrics, logs, and alarms.
AWS App Mesh
Service mesh integration for automatic tracing of Envoy-based microservices.
OpenTelemetry
X-Ray supports the OpenTelemetry standard via the AWS Distro for OpenTelemetry.
Resources
Get Started 4
Portal, sign-up, and the first successful call
Documentation 1
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 2
Pagination, idempotency, versioning, errors, and events
Build 2
SDKs, sample code, and the tooling you integrate with
Access & Security 4
Authentication, authorization, and security posture
Learn 1
Tutorials, courses, talks, and written guidance
Operate 4
Status, limits, changes, and where to get help
Commercial 2
Pricing, plans, and the legal terms of use
Company 2
The organization behind the API
Other 1
Properties that don't map to a standard resource type