AWS IoT Events Data

amazonaws · Cloud

Cloud No Auth Free & Open cloud

IoT Events monitors your equipment or device fleets for failures or changes in operation, and triggers actions when such events occur. You can use IoT Events Data API commands to send inputs to detectors, list detectors, and view or update a detector's status. For more information, see What is IoT Events? in the IoT Events Developer Guide .

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET ListAlarms

Lists one or more alarms. The operation returns only the metadata associated with each alarm.

https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/alarms/{alarmModelName}?nextToken=example&maxResults=1

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/alarms/{alarmModelName}?nextToken=example&maxResults=1"

import requests
params = {
    "nextToken": "example",
    "maxResults": "1"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/alarms/{alarmModelName}",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/alarms/{alarmModelName}');
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/iotevents-data/2018-10-23/alarms/{alarmModelName}")
	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/iotevents-data/2018-10-23/alarms/{alarmModelName}")
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/iotevents-data/2018-10-23/alarms/{alarmModelName}?" . 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 ListDetectors

Lists detectors (the instances of a detector model).

https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/detectors/{detectorModelName}?nextToken=example&stateName=example&maxResults=1

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/detectors/{detectorModelName}?nextToken=example&stateName=example&maxResults=1"

import requests
params = {
    "nextToken": "example",
    "stateName": "example",
    "maxResults": "1"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/detectors/{detectorModelName}",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/detectors/{detectorModelName}');
url.searchParams.set('nextToken', 'example');
url.searchParams.set('stateName', '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/iotevents-data/2018-10-23/detectors/{detectorModelName}")
	q := baseURL.Query()
	q.Set("nextToken", "example")
	q.Set("stateName", "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/iotevents-data/2018-10-23/detectors/{detectorModelName}")
uri.query = URI.encode_www_form({
  "nextToken" => "example",
  "stateName" => "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/iotevents-data/2018-10-23/detectors/{detectorModelName}?" . http_build_query([
    "nextToken" => "example",
    "stateName" => "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 DescribeAlarm

Retrieves information about an alarm.

https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/alarms/{alarmModelName}/keyValues?keyValue=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/alarms/{alarmModelName}/keyValues/?keyValue=example"

import requests
params = {
    "keyValue": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/alarms/{alarmModelName}/keyValues/",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/iotevents-data/2018-10-23/alarms/{alarmModelName}/keyValues/');
url.searchParams.set('keyValue', '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/iotevents-data/2018-10-23/alarms/{alarmModelName}/keyValues/")
	q := baseURL.Query()
	q.Set("keyValue", "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/iotevents-data/2018-10-23/alarms/{alarmModelName}/keyValues/")
uri.query = URI.encode_www_form({
  "keyValue" => "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/iotevents-data/2018-10-23/alarms/{alarmModelName}/keyValues/?" . http_build_query([
    "keyValue" => "example"
]);
$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 Events Data?

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