AWS X-Ray

amazonaws · Cloud

Cloud No Auth Free & Open cloud

Amazon Web Services X-Ray provides APIs for managing debug traces and retrieving service maps and other data created by processing those traces.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

POST BatchGetTraces

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

https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Traces?NextToken=example

Hover any highlighted part to learn what it does

curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Traces?NextToken=example"

import requests
params = {
    "NextToken": "example"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Traces",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Traces');
url.searchParams.set('NextToken', 'example');

const response = await fetch(url, {
  method: 'POST',
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Traces")
	q := baseURL.Query()
	q.Set("NextToken", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("POST", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Traces")
uri.query = URI.encode_www_form({
  "NextToken" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Traces?" . http_build_query([
    "NextToken" => "example"
]);
$opts = ["http" => [
    "method" => "POST",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

POST GetGroups

Retrieves all active group details.

https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Groups?NextToken=example

Hover any highlighted part to learn what it does

curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Groups?NextToken=example"

import requests
params = {
    "NextToken": "example"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Groups",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Groups');
url.searchParams.set('NextToken', 'example');

const response = await fetch(url, {
  method: 'POST',
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Groups")
	q := baseURL.Query()
	q.Set("NextToken", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("POST", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Groups")
uri.query = URI.encode_www_form({
  "NextToken" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/Groups?" . http_build_query([
    "NextToken" => "example"
]);
$opts = ["http" => [
    "method" => "POST",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

POST GetInsightEvents

X-Ray reevaluates insights periodically until they're resolved, and records each intermediate state as an event. You can review an insight's events in the Impact Timeline on the Inspect page in the X-Ray console.

https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/InsightEvents?NextToken=example&MaxResults=example

Hover any highlighted part to learn what it does

curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/InsightEvents?NextToken=example&MaxResults=example"

import requests
params = {
    "NextToken": "example",
    "MaxResults": "example"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/InsightEvents",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/InsightEvents');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');

const response = await fetch(url, {
  method: 'POST',
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/InsightEvents")
	q := baseURL.Query()
	q.Set("NextToken", "example")
	q.Set("MaxResults", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("POST", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/InsightEvents")
uri.query = URI.encode_www_form({
  "NextToken" => "example",
  "MaxResults" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/xray/2016-04-12/InsightEvents?" . http_build_query([
    "NextToken" => "example",
    "MaxResults" => "example"
]);
$opts = ["http" => [
    "method" => "POST",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with AWS X-Ray?

AWS X-Ray is a Cloud API. Developers commonly use cloud APIs for:

provisioning and managing cloud infrastructure
automating deployments and container orchestration
monitoring uptime and performance metrics
managing storage buckets and databases
setting up auto-scaling and load balancing

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. AWS X-Ray is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗