AWS IoT 1-Click Devices Service

amazonaws · Cloud

Cloud No Auth Free & Open cloud Sandbox

Describes all of the AWS IoT 1-Click device-related API operations for the service. Also provides sample requests, responses, and errors for the supported web services protocols.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET ListDevices

Lists the 1-Click compatible devices associated with your AWS account.

https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices?nextToken=example&deviceType=example&maxResults=1

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices?nextToken=example&deviceType=example&maxResults=1"

import requests
params = {
    "nextToken": "example",
    "deviceType": "example",
    "maxResults": "1"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices');
url.searchParams.set('nextToken', 'example');
url.searchParams.set('deviceType', '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/iot1click-devices/2018-05-14/devices")
	q := baseURL.Query()
	q.Set("nextToken", "example")
	q.Set("deviceType", "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/iot1click-devices/2018-05-14/devices")
uri.query = URI.encode_www_form({
  "nextToken" => "example",
  "deviceType" => "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/iot1click-devices/2018-05-14/devices?" . http_build_query([
    "nextToken" => "example",
    "deviceType" => "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 ListDeviceEvents

Using a device ID, returns a DeviceEventsResponse object containing an array of events for the device.

https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices/{deviceId}/events#fromTimeStamp&toTimeStamp?nextToken=example&maxResults=1&toTimeStamp=example&fromTimeStamp=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices/{deviceId}/events#fromTimeStamp&toTimeStamp?nextToken=example&maxResults=1&toTimeStamp=example&fromTimeStamp=example"

import requests
params = {
    "nextToken": "example",
    "maxResults": "1",
    "toTimeStamp": "example",
    "fromTimeStamp": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices/{deviceId}/events#fromTimeStamp&toTimeStamp",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices/{deviceId}/events#fromTimeStamp&toTimeStamp');
url.searchParams.set('nextToken', 'example');
url.searchParams.set('maxResults', '1');
url.searchParams.set('toTimeStamp', 'example');
url.searchParams.set('fromTimeStamp', 'example');

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/iot1click-devices/2018-05-14/devices/{deviceId}/events#fromTimeStamp&toTimeStamp")
	q := baseURL.Query()
	q.Set("nextToken", "example")
	q.Set("maxResults", "1")
	q.Set("toTimeStamp", "example")
	q.Set("fromTimeStamp", "example")
	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/iot1click-devices/2018-05-14/devices/{deviceId}/events#fromTimeStamp&toTimeStamp")
uri.query = URI.encode_www_form({
  "nextToken" => "example",
  "maxResults" => "1",
  "toTimeStamp" => "example",
  "fromTimeStamp" => "example"
})

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/iot1click-devices/2018-05-14/devices/{deviceId}/events#fromTimeStamp&toTimeStamp?" . http_build_query([
    "nextToken" => "example",
    "maxResults" => "1",
    "toTimeStamp" => "example",
    "fromTimeStamp" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET DescribeDevice

Given a device ID, returns a DescribeDeviceResponse object describing the details of the device.

https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices/{deviceId}

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices/{deviceId}"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices/{deviceId}",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/amazonaws.com/iot1click-devices/2018-05-14/devices/{deviceId}';

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/iot1click-devices/2018-05-14/devices/{deviceId}"
	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/iot1click-devices/2018-05-14/devices/{deviceId}")

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/iot1click-devices/2018-05-14/devices/{deviceId}";
$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 1-Click Devices Service?

AWS IoT 1-Click Devices Service 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 1-Click Devices Service is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗