AWS IoT Data Plane

amazonaws · Cloud

Cloud No Auth Free & Open cloud

IoT data IoT data enables secure, bi-directional communication between Internet-connected things (such as sensors, actuators, embedded devices, or smart appliances) and the Amazon Web Services cloud. It implements a broker for applications and things to publish messages over HTTP (Publish) and retrieve, update, and delete shadows. A shadow is a persistent representation of your things and their state in the Amazon Web Services cloud. Find the endpoint address for a

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET ListRetainedMessages

Lists summary information about the retained messages stored for the account. This action returns only the topic names of the retained messages. It doesn't return any message payloads. Although this action doesn't return a message payload, it can still incur messaging costs. To get

https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage?nextToken=example&maxResults=1

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage?nextToken=example&maxResults=1"

import requests
params = {
    "nextToken": "example",
    "maxResults": "1"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage');
url.searchParams.set('nextToken', 'example');
url.searchParams.set('maxResults', '1');

const response = await fetch(url); 
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/iot-data/2015-05-28/retainedMessage")
	q := baseURL.Query()
	q.Set("nextToken", "example")
	q.Set("maxResults", "1")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", 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/iot-data/2015-05-28/retainedMessage")
uri.query = URI.encode_www_form({
  "nextToken" => "example",
  "maxResults" => "1"
})

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

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

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

<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage?" . http_build_query([
    "nextToken" => "example",
    "maxResults" => "1"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET GetThingShadow

Gets the shadow for the specified thing. Requires permission to access the GetThingShadow action. For more information, see <a href="http://docs.aws.amazon

https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/things/{thingName}/shadow?name=test

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/things/{thingName}/shadow?name=test"

import requests
params = {
    "name": "test"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/things/{thingName}/shadow",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/things/{thingName}/shadow');
url.searchParams.set('name', 'test');

const response = await fetch(url); 
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/iot-data/2015-05-28/things/{thingName}/shadow")
	q := baseURL.Query()
	q.Set("name", "test")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", 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/iot-data/2015-05-28/things/{thingName}/shadow")
uri.query = URI.encode_www_form({
  "name" => "test"
})

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

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

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

<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/things/{thingName}/shadow?" . http_build_query([
    "name" => "test"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET GetRetainedMessage

Gets the details of a single retained message for the specified topic. This action returns the message payload of the retained message, which can incur messaging costs. To list only the topic names of the retained messages, call <a href="https://docs.aws.amazon.com/iot/latest/apireference/

https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage/{topic}

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage/{topic}"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage/{topic}",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage/{topic}';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

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

func main() {
	targetURL := "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage/{topic}"
	req, _ := http.NewRequest("GET", 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/iot-data/2015-05-28/retainedMessage/{topic}")

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

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

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

<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/iot-data/2015-05-28/retainedMessage/{topic}";
$opts = ["http" => [
    "method" => "GET",
]];
$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 IoT Data Plane?

AWS IoT Data Plane 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 IoT Data Plane 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 ↗