Find an API

Search public APIs with auth details & Postman guides

← All APIs

AWS Shield

amazonaws · Cloud

Cloud No Auth Free & Open cloud Sandbox

Shield Advanced This is the Shield Advanced API Reference . This guide is for developers who need detailed information about the Shield Advanced API actions, data types, and errors. For detailed information about WAF and Shield Advanced features and an overview of how to use the WAF and Shield Advanced APIs, see the WAF and Shield Developer Guide .

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

POST ListAttacks

Returns all ongoing DDoS attacks or all DDoS attacks during a specified time period.

https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListAttacks?NextToken=example&MaxResults=example

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
X-Amz-Target AWSShield_20160616.ListAttacks 
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListAttacks?NextToken=example&MaxResults=example" \
  -H "X-Amz-Target: AWSShield_20160616.ListAttacks"
import requests
params = {
    "NextToken": "example",
    "MaxResults": "example"
}
headers = {
    "X-Amz-Target": "AWSShield_20160616.ListAttacks"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListAttacks",
    params=params,
    headers=headers,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListAttacks');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-Amz-Target': 'AWSShield_20160616.ListAttacks'
  },
}); 
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/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListAttacks")
	q := baseURL.Query()
	q.Set("NextToken", "example")
	q.Set("MaxResults", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("X-Amz-Target", "AWSShield_20160616.ListAttacks")

	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/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListAttacks")
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)
req["X-Amz-Target"] = "AWSShield_20160616.ListAttacks"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListAttacks?" . http_build_query([
    "NextToken" => "example",
    "MaxResults" => "example"
]);
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "X-Amz-Target: AWSShield_20160616.ListAttacks"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
POST ListProtectionGroups

Retrieves ProtectionGroup objects for the account. You can retrieve all protection groups or you can provide filtering criteria and retrieve just the subset of protection groups that match the criteria.

https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtectionGroups?NextToken=example&MaxResults=example

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
X-Amz-Target AWSShield_20160616.ListProtectionGroups 
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtectionGroups?NextToken=example&MaxResults=example" \
  -H "X-Amz-Target: AWSShield_20160616.ListProtectionGroups"
import requests
params = {
    "NextToken": "example",
    "MaxResults": "example"
}
headers = {
    "X-Amz-Target": "AWSShield_20160616.ListProtectionGroups"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtectionGroups",
    params=params,
    headers=headers,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtectionGroups');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-Amz-Target': 'AWSShield_20160616.ListProtectionGroups'
  },
}); 
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/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtectionGroups")
	q := baseURL.Query()
	q.Set("NextToken", "example")
	q.Set("MaxResults", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("X-Amz-Target", "AWSShield_20160616.ListProtectionGroups")

	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/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtectionGroups")
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)
req["X-Amz-Target"] = "AWSShield_20160616.ListProtectionGroups"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtectionGroups?" . http_build_query([
    "NextToken" => "example",
    "MaxResults" => "example"
]);
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "X-Amz-Target: AWSShield_20160616.ListProtectionGroups"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
POST ListProtections

Retrieves Protection objects for the account. You can retrieve all protections or you can provide filtering criteria and retrieve just the subset of protections that match the criteria.

https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtections?NextToken=example&MaxResults=example

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
X-Amz-Target AWSShield_20160616.ListProtections 
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtections?NextToken=example&MaxResults=example" \
  -H "X-Amz-Target: AWSShield_20160616.ListProtections"
import requests
params = {
    "NextToken": "example",
    "MaxResults": "example"
}
headers = {
    "X-Amz-Target": "AWSShield_20160616.ListProtections"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtections",
    params=params,
    headers=headers,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtections');
url.searchParams.set('NextToken', 'example');
url.searchParams.set('MaxResults', 'example');

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-Amz-Target': 'AWSShield_20160616.ListProtections'
  },
}); 
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/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtections")
	q := baseURL.Query()
	q.Set("NextToken", "example")
	q.Set("MaxResults", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("X-Amz-Target", "AWSShield_20160616.ListProtections")

	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/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtections")
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)
req["X-Amz-Target"] = "AWSShield_20160616.ListProtections"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/shield/2016-06-02/#X-Amz-Target=AWSShield_20160616.ListProtections?" . http_build_query([
    "NextToken" => "example",
    "MaxResults" => "example"
]);
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "X-Amz-Target: AWSShield_20160616.ListProtections"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗
  1. See official documentation for authentication and setup.

What can you build with AWS Shield?

AWS Shield 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 Shield is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗