AWS X-Ray website screenshot

AWS X-Ray

AWS X-Ray is a service that helps developers analyze and debug distributed applications by providing end-to-end tracing of requests as they travel through the application, identifying performance bottlenecks and errors. It is now part of Amazon CloudWatch Application Signals for unified observability.

AWS X-Ray publishes 9 APIs on the APIs.io network, including Encryption API, Groups API, Insights API, and 6 more. Tagged areas include Debugging, Distributed Tracing, Microservices, and Observability.

The AWS X-Ray catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

AWS X-Ray’s developer surface includes authentication, documentation, getting-started guide, pricing, FAQ, support, engineering blog, and 11 more developer resources.

🌐 Visit website 📡 Source on GitHub
62.5/100 strong ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
9 APIs 9 Features 5 Use Cases
DebuggingDistributed TracingMicroservicesObservability

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 62.5/100 · strong
Contract Quality 17.6 / 25
Developer Ergonomics 8.3 / 20
Commercial Clarity 15.8 / 20
Operational Transparency 6.2 / 13
Governance 8.3 / 12
Discoverability 6.5 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/aws-x-ray: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

AWS X-Ray Encryption API

Manage encryption configuration

AWS X-Ray Groups API

Manage trace groups

AWS X-Ray Insights API

Automated anomaly detection insights

AWS X-Ray Sampling API

Manage sampling rules

AWS X-Ray Service Graph API

Service map and statistics

AWS X-Ray TagResource API

The TagResource API from AWS X-Ray — 1 operation(s) for tagresource.

AWS X-Ray Tags API

The Tags API from AWS X-Ray — 1 operation(s) for tags.

AWS X-Ray Traces API

Upload and retrieve trace data

AWS X-Ray UntagResource API

The UntagResource API from AWS X-Ray — 1 operation(s) for untagresource.

Scroll for all 9

Postman Collections 9

Ready-to-run Postman collections for exercising this provider's APIs.

AWS X-Ray Encryption API

POSTMAN

AWS X-Ray Encryption Groups API

POSTMAN

AWS X-Ray Encryption Insights API

POSTMAN

AWS X-Ray Encryption Sampling API

POSTMAN

AWS X-Ray Encryption Service Graph API

POSTMAN

AWS X-Ray Encryption TagResource API

POSTMAN

AWS X-Ray Encryption Tags API

POSTMAN

AWS X-Ray Encryption Traces API

POSTMAN

AWS X-Ray Encryption UntagResource API

POSTMAN

Scroll for all 9

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

AWS X-Ray API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Aws X Ray Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Aws X Ray Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Aws X Ray Finops

FINOPS

Features 9

Notable capabilities this provider offers.

End-to-End Tracing

Trace requests from client to backend across all services in your distributed application.

Service Map

Visualize service dependencies and real-time health indicators in an interactive map.

Trace Analytics

Filter, search, and analyze traces using filter expressions and groups.

Sampling Rules

Control trace collection rates with dynamic sampling rules to manage cost and volume.

Annotations and Metadata

Add indexed annotations and non-indexed metadata to traces for custom filtering and context.

Error Analysis

Identify and analyze errors, faults, and throttling across distributed services.

Latency Analysis

Identify performance bottlenecks with detailed latency histograms and percentile data.

CloudWatch Integration

Integrated with CloudWatch Application Signals for unified observability and alerting.

SDK Support

Instrument applications with X-Ray SDKs for Java, Python, Go, Node.js, Ruby, and .NET.

Scroll for all 9

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Aws X Ray Context

19 classes · 0 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

AWS X-Ray API Rules

5 rules · 3 warnings 2 info

SPECTRAL

AWS X-Ray API Rules

12 rules · 4 errors 7 warnings 1 info

SPECTRAL

JSON Schema 19

Standalone JSON Schema definitions for this provider's data models.

BatchGetTracesResult

3 properties

JSON SCHEMA

EdgeStatistics

5 properties

JSON SCHEMA

EncryptionConfig

3 properties

JSON SCHEMA

GetServiceGraphResult

5 properties

JSON SCHEMA

GetTraceSummariesResult

4 properties

JSON SCHEMA

Group

4 properties

JSON SCHEMA

GroupSummary

4 properties

JSON SCHEMA

HistogramEntry

2 properties

JSON SCHEMA

Insight

12 properties

JSON SCHEMA

InsightSummary

13 properties

JSON SCHEMA

SamplingRule

13 properties

JSON SCHEMA

SamplingRuleRecord

3 properties

JSON SCHEMA

Service

13 properties

JSON SCHEMA

ServiceId

4 properties

JSON SCHEMA

ServiceStatistics

5 properties

JSON SCHEMA

Tag

2 properties

JSON SCHEMA

TimeSeriesServiceStatistics

5 properties

JSON SCHEMA

Trace

4 properties

JSON SCHEMA

TraceSummary

13 properties

JSON SCHEMA

Scroll for all 19

JSON Structure 19

JSON Structure definitions describing this provider's data shapes.

X Ray Batchgettracesresult Structure

0 properties

JSON STRUCTURE

X Ray Edgestatistics Structure

0 properties

JSON STRUCTURE

X Ray Encryptionconfig Structure

0 properties

JSON STRUCTURE

X Ray Getservicegraphresult Structure

0 properties

JSON STRUCTURE

X Ray Gettracesummariesresult Structure

0 properties

JSON STRUCTURE

X Ray Group Structure

0 properties

JSON STRUCTURE

X Ray Groupsummary Structure

0 properties

JSON STRUCTURE

X Ray Histogramentry Structure

0 properties

JSON STRUCTURE

X Ray Insight Structure

0 properties

JSON STRUCTURE

X Ray Insightsummary Structure

0 properties

JSON STRUCTURE

X Ray Samplingrule Structure

0 properties

JSON STRUCTURE

X Ray Samplingrulerecord Structure

0 properties

JSON STRUCTURE

X Ray Service Structure

0 properties

JSON STRUCTURE

X Ray Serviceid Structure

0 properties

JSON STRUCTURE

X Ray Servicestatistics Structure

0 properties

JSON STRUCTURE

X Ray Tag Structure

0 properties

JSON STRUCTURE

X Ray Timeseriesservicestatistics Structure

0 properties

JSON STRUCTURE

X Ray Trace Structure

0 properties

JSON STRUCTURE

X Ray Tracesummary Structure

0 properties

JSON STRUCTURE

Scroll for all 19

Examples 19

Example request and response payloads for these APIs.

X Ray Batchgettracesresult Example

3 fields

EXAMPLE

X Ray Edgestatistics Example

3 fields

EXAMPLE

X Ray Encryptionconfig Example

3 fields

EXAMPLE

X Ray Getservicegraphresult Example

3 fields

EXAMPLE

X Ray Gettracesummariesresult Example

3 fields

EXAMPLE

X Ray Group Example

3 fields

EXAMPLE

X Ray Groupsummary Example

3 fields

EXAMPLE

X Ray Histogramentry Example

3 fields

EXAMPLE

X Ray Insight Example

3 fields

EXAMPLE

X Ray Insightsummary Example

3 fields

EXAMPLE

X Ray Samplingrule Example

3 fields

EXAMPLE

X Ray Samplingrulerecord Example

3 fields

EXAMPLE

X Ray Service Example

3 fields

EXAMPLE

X Ray Serviceid Example

3 fields

EXAMPLE

X Ray Servicestatistics Example

3 fields

EXAMPLE

X Ray Tag Example

3 fields

EXAMPLE

X Ray Timeseriesservicestatistics Example

3 fields

EXAMPLE

X Ray Trace Example

3 fields

EXAMPLE

X Ray Tracesummary Example

3 fields

EXAMPLE

Scroll for all 19

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Aws X Ray Authentication

apiKey · 1 scheme

SECURITY

Aws X Ray Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Aws X Ray Vulnerability Disclosure

security.txt · contact published

SECURITY

Aws X Ray Trust Center

PCI DSS, HIPAA, FedRAMP, GDPR, FIPS 140

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Aws X Ray Agentic Access

22 operations · 22 acting

22 operations · 22 acting

AGENTIC

Use Cases 5

What developers build with this provider.

Performance Optimization

Identify and resolve latency bottlenecks in distributed microservices applications.

Error Debugging

Trace errors and exceptions to their root cause across service boundaries.

Dependency Analysis

Understand service dependencies and the impact of downstream failures.

SLA Monitoring

Monitor request latency and error rates against service level agreements.

Microservices Visibility

Gain observability into complex microservices architectures and their interactions.

Resources

Get Started 1

Portal, sign-up, and the first successful call

GettingStarted
GettingStarted

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

SpectralRules
SpectralRules
 Vocabulary
Vocabulary

Build 1

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace
PostmanWorkspace

Access & Security 4

Authentication, authorization, and security posture

TrustCenter
TrustCenter
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 3

Status, limits, changes, and where to get help

FAQ
FAQ
 Support
Support
 StatusPage
StatusPage

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 2

The organization behind the API

Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: aws-x-ray
name: AWS X-Ray
description: AWS X-Ray is a service that helps developers analyze and debug distributed applications by providing end-to-end
  tracing of requests as they travel through the application, identifying performance bottlenecks and errors. It is now part
  of Amazon CloudWatch Application Signals for unified observability.
type: Index
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/aws-x-ray.png
tags:
- AWS
- Debugging
- Distributed Tracing
- Microservices
- Observability
url: https://raw.githubusercontent.com/api-evangelist/aws-x-ray/refs/heads/main/apis.yml
created: '2026-03-26'
modified: '2026-05-19'
specificationVersion: '0.19'
apis:
- aid: aws-x-ray:aws-x-ray-encryption-api
  name: AWS X-Ray Encryption API
  description: Manage encryption configuration
  humanURL: https://aws.amazon.com/xray/
  baseURL: https://xray.{region}.amazonaws.com
  tags:
  - Encryption
  properties:
  - type: OpenAPI
    url: openapi/aws-x-ray-encryption-api-openapi.yml
  - type: JSONSchema
    url: json-schema/aws-x-ray-trace-segment.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
  - type: APIReference
    url: https://docs.aws.amazon.com/xray/latest/api/Welcome.html
- aid: aws-x-ray:aws-x-ray-groups-api
  name: AWS X-Ray Groups API
  description: Manage trace groups
  humanURL: https://aws.amazon.com/xray/
  baseURL: https://xray.{region}.amazonaws.com
  tags:
  - Groups
  properties:
  - type: OpenAPI
    url: openapi/aws-x-ray-groups-api-openapi.yml
  - type: JSONSchema
    url: json-schema/aws-x-ray-trace-segment.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
  - type: APIReference
    url: https://docs.aws.amazon.com/xray/latest/api/Welcome.html
- aid: aws-x-ray:aws-x-ray-insights-api
  name: AWS X-Ray Insights API
  description: Automated anomaly detection insights
  humanURL: https://aws.amazon.com/xray/
  baseURL: https://xray.{region}.amazonaws.com
  tags:
  - Insights
  properties:
  - type: OpenAPI
    url: openapi/aws-x-ray-insights-api-openapi.yml
  - type: JSONSchema
    url: json-schema/aws-x-ray-trace-segment.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
  - type: APIReference
    url: https://docs.aws.amazon.com/xray/latest/api/Welcome.html
- aid: aws-x-ray:aws-x-ray-sampling-api
  name: AWS X-Ray Sampling API
  description: Manage sampling rules
  humanURL: https://aws.amazon.com/xray/
  baseURL: https://xray.{region}.amazonaws.com
  tags:
  - Sampling
  properties:
  - type: OpenAPI
    url: openapi/aws-x-ray-sampling-api-openapi.yml
  - type: JSONSchema
    url: json-schema/aws-x-ray-trace-segment.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
  - type: APIReference
    url: https://docs.aws.amazon.com/xray/latest/api/Welcome.html
- aid: aws-x-ray:aws-x-ray-service-graph-api
  name: AWS X-Ray Service Graph API
  description: Service map and statistics
  humanURL: https://aws.amazon.com/xray/
  baseURL: https://xray.{region}.amazonaws.com
  tags:
  - Service Graph
  properties:
  - type: OpenAPI
    url: openapi/aws-x-ray-service-graph-api-openapi.yml
  - type: JSONSchema
    url: json-schema/aws-x-ray-trace-segment.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
  - type: APIReference
    url: https://docs.aws.amazon.com/xray/latest/api/Welcome.html
- aid: aws-x-ray:aws-x-ray-tagresource-api
  name: AWS X-Ray TagResource API
  description: The TagResource API from AWS X-Ray — 1 operation(s) for tagresource.
  humanURL: https://aws.amazon.com/xray/
  baseURL: https://xray.{region}.amazonaws.com
  tags:
  - TagResource
  properties:
  - type: OpenAPI
    url: openapi/aws-x-ray-tagresource-api-openapi.yml
  - type: JSONSchema
    url: json-schema/aws-x-ray-trace-segment.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
  - type: APIReference
    url: https://docs.aws.amazon.com/xray/latest/api/Welcome.html
- aid: aws-x-ray:aws-x-ray-tags-api
  name: AWS X-Ray Tags API
  description: The Tags API from AWS X-Ray — 1 operation(s) for tags.
  humanURL: https://aws.amazon.com/xray/
  baseURL: https://xray.{region}.amazonaws.com
  tags:
  - Tags
  properties:
  - type: OpenAPI
    url: openapi/aws-x-ray-tags-api-openapi.yml
  - type: JSONSchema
    url: json-schema/aws-x-ray-trace-segment.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
  - type: APIReference
    url: https://docs.aws.amazon.com/xray/latest/api/Welcome.html
- aid: aws-x-ray:aws-x-ray-traces-api
  name: AWS X-Ray Traces API
  description: Upload and retrieve trace data
  humanURL: https://aws.amazon.com/xray/
  baseURL: https://xray.{region}.amazonaws.com
  tags:
  - Traces
  properties:
  - type: OpenAPI
    url: openapi/aws-x-ray-traces-api-openapi.yml
  - type: JSONSchema
    url: json-schema/aws-x-ray-trace-segment.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
  - type: APIReference
    url: https://docs.aws.amazon.com/xray/latest/api/Welcome.html
- aid: aws-x-ray:aws-x-ray-untagresource-api
  name: AWS X-Ray UntagResource API
  description: The UntagResource API from AWS X-Ray — 1 operation(s) for untagresource.
  humanURL: https://aws.amazon.com/xray/
  baseURL: https://xray.{region}.amazonaws.com
  tags:
  - UntagResource
  properties:
  - type: OpenAPI
    url: openapi/aws-x-ray-untagresource-api-openapi.yml
  - type: JSONSchema
    url: json-schema/aws-x-ray-trace-segment.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
  - type: APIReference
    url: https://docs.aws.amazon.com/xray/latest/api/Welcome.html
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/aws-x-ray/overview
- type: AgenticAccess
  url: agentic-access/aws-x-ray-agentic-access.yml
- type: TrustCenter
  url: security/aws-x-ray-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/aws-x-ray-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/aws-x-ray-domain-security.yml
- type: Authentication
  url: authentication/aws-x-ray-authentication.yml
- type: Website
  url: https://aws.amazon.com/xray/
- type: Documentation
  url: https://docs.aws.amazon.com/xray/latest/devguide/aws-xray.html
- type: GettingStarted
  url: https://aws.amazon.com/xray/getting-started/
- type: Pricing
  url: https://aws.amazon.com/xray/pricing/
- type: FAQ
  url: https://aws.amazon.com/xray/faqs/
- type: TermsOfService
  url: https://aws.amazon.com/service-terms/
- type: PrivacyPolicy
  url: https://aws.amazon.com/privacy/
- type: Support
  url: https://aws.amazon.com/premiumsupport/
- type: Blog
  url: https://aws.amazon.com/blogs/devops/category/management-tools/aws-x-ray/
- type: StatusPage
  url: https://health.aws.amazon.com/health/status
- type: SpectralRules
  url: rules/aws-x-ray-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/aws-x-ray-vocabulary.yaml
- type: Features
  data:
  - name: End-to-End Tracing
    description: Trace requests from client to backend across all services in your distributed application.
  - name: Service Map
    description: Visualize service dependencies and real-time health indicators in an interactive map.
  - name: Trace Analytics
    description: Filter, search, and analyze traces using filter expressions and groups.
  - name: Sampling Rules
    description: Control trace collection rates with dynamic sampling rules to manage cost and volume.
  - name: Annotations and Metadata
    description: Add indexed annotations and non-indexed metadata to traces for custom filtering and context.
  - name: Error Analysis
    description: Identify and analyze errors, faults, and throttling across distributed services.
  - name: Latency Analysis
    description: Identify performance bottlenecks with detailed latency histograms and percentile data.
  - name: CloudWatch Integration
    description: Integrated with CloudWatch Application Signals for unified observability and alerting.
  - name: SDK Support
    description: Instrument applications with X-Ray SDKs for Java, Python, Go, Node.js, Ruby, and .NET.
- type: UseCases
  data:
  - name: Performance Optimization
    description: Identify and resolve latency bottlenecks in distributed microservices applications.
  - name: Error Debugging
    description: Trace errors and exceptions to their root cause across service boundaries.
  - name: Dependency Analysis
    description: Understand service dependencies and the impact of downstream failures.
  - name: SLA Monitoring
    description: Monitor request latency and error rates against service level agreements.
  - name: Microservices Visibility
    description: Gain observability into complex microservices architectures and their interactions.
- type: Integrations
  data:
  - name: AWS Lambda
    description: Automatically instrument Lambda functions with X-Ray active tracing.
  - name: Amazon API Gateway
    description: Enable X-Ray tracing on API Gateway stages for end-to-end visibility.
  - name: Amazon ECS
    description: Collect traces from containerized applications running on ECS.
  - name: AWS Elastic Beanstalk
    description: Enable X-Ray on Elastic Beanstalk environments for application tracing.
  - name: Amazon CloudWatch
    description: Unified observability with CloudWatch Application Signals and alarms.
  - name: AWS Step Functions
    description: Trace state machine executions through Step Functions workflows.
- type: Integrations
  url: https://aws.amazon.com/marketplace
integrations:
- name: Sign in
- name: Agent Mode
- name: Why AWS Marketplace?
- name: Get started in AWS Marketplace
- name: Industry
- name: Resources
- name: Become a Channel Partner
- name: Sell in AWS Marketplace
- name: Manage Your Account
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com