Find an API

Search public APIs with auth details & Postman guides

← All APIs

AWS IoT Secure Tunneling

amazonaws · Cloud

Cloud No Auth Free & Open cloud Sandbox

IoT Secure Tunneling IoT Secure Tunneling creates remote connections to devices deployed in the field. For more information about how IoT Secure Tunneling works, see IoT Secure Tunneling .

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

POST ListTunnels

List all tunnels for an Amazon Web Services account. Tunnels are listed by creation time in descending order, newer tunnels will be listed before older tunnels. Requires permission to access the <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#aw

https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.ListTunnels?nextToken=example&maxResults=example

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
X-Amz-Target IoTSecuredTunneling.ListTunnels 
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.ListTunnels?nextToken=example&maxResults=example" \
  -H "X-Amz-Target: IoTSecuredTunneling.ListTunnels"
import requests
params = {
    "nextToken": "example",
    "maxResults": "example"
}
headers = {
    "X-Amz-Target": "IoTSecuredTunneling.ListTunnels"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.ListTunnels",
    params=params,
    headers=headers,
)
print(response.json())
const url = new URL('https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.ListTunnels');
url.searchParams.set('nextToken', 'example');
url.searchParams.set('maxResults', 'example');

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-Amz-Target': 'IoTSecuredTunneling.ListTunnels'
  },
}); 
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/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.ListTunnels")
	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", "IoTSecuredTunneling.ListTunnels")

	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/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.ListTunnels")
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"] = "IoTSecuredTunneling.ListTunnels"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.ListTunnels?" . http_build_query([
    "nextToken" => "example",
    "maxResults" => "example"
]);
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "X-Amz-Target: IoTSecuredTunneling.ListTunnels"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
POST CloseTunnel

Closes a tunnel identified by the unique tunnel id. When a CloseTunnel request is received, we close the WebSocket connections between the client and proxy server so no data can be transmitted. Requires permission to access the <a href="https://docs.aws.amazon.com/service-auth

https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.CloseTunnel

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
X-Amz-Target IoTSecuredTunneling.CloseTunnel 
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.CloseTunnel" \
  -H "X-Amz-Target: IoTSecuredTunneling.CloseTunnel"
import requests
headers = {
    "X-Amz-Target": "IoTSecuredTunneling.CloseTunnel"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.CloseTunnel",
    headers=headers,
)
print(response.json())
const url = 'https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.CloseTunnel';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-Amz-Target': 'IoTSecuredTunneling.CloseTunnel'
  },
}); 
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/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.CloseTunnel"
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("X-Amz-Target", "IoTSecuredTunneling.CloseTunnel")

	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/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.CloseTunnel")

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

req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "IoTSecuredTunneling.CloseTunnel"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.CloseTunnel";
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "X-Amz-Target: IoTSecuredTunneling.CloseTunnel"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
POST DescribeTunnel

Gets information about a tunnel identified by the unique tunnel id. Requires permission to access the DescribeTunnel action.

https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.DescribeTunnel

Hover any highlighted part to learn what it does

Headers — extra info sent with the request
X-Amz-Target IoTSecuredTunneling.DescribeTunnel 
curl -X POST "https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.DescribeTunnel" \
  -H "X-Amz-Target: IoTSecuredTunneling.DescribeTunnel"
import requests
headers = {
    "X-Amz-Target": "IoTSecuredTunneling.DescribeTunnel"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.DescribeTunnel",
    headers=headers,
)
print(response.json())
const url = 'https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.DescribeTunnel';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-Amz-Target': 'IoTSecuredTunneling.DescribeTunnel'
  },
}); 
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/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.DescribeTunnel"
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("X-Amz-Target", "IoTSecuredTunneling.DescribeTunnel")

	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/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.DescribeTunnel")

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

req = Net::HTTP::Post.new(uri)
req["X-Amz-Target"] = "IoTSecuredTunneling.DescribeTunnel"

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/iotsecuretunneling/2018-10-05/#X-Amz-Target=IoTSecuredTunneling.DescribeTunnel";
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "X-Amz-Target: IoTSecuredTunneling.DescribeTunnel"
    ]),
]];
$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 IoT Secure Tunneling?

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

New to APIs? Read our beginner's guide

Open documentation ↗