Find an API

Search public APIs with auth details & Postman guides

← All APIs

Amazon DynamoDB Streams

amazonaws · Cloud

Cloud No Auth Free & Open cloud Sandbox

Amazon DynamoDB Amazon DynamoDB Streams provides API actions for accessing streams and processing stream records. To learn more about application development with Streams, see Capturing Table Activity with DynamoDB Streams in the Amazon DynamoDB Developer Guide.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

POST DescribeStream

Returns information about a stream, including the current status of the stream, its Amazon Resource Name (ARN), the composition of its shards, and its corresponding DynamoDB table. You can call DescribeStream at a maximum rate of 10 times per second. Each

https://api.apis.guru/v2/specs/amazonaws.com/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.DescribeStream

Hover any highlighted part to learn what it does

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

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-Amz-Target': 'DynamoDBStreams_20120810.DescribeStream'
  },
}); 
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/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.DescribeStream"
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("X-Amz-Target", "DynamoDBStreams_20120810.DescribeStream")

	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/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.DescribeStream")

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

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

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

Retrieves the stream records from a given shard. Specify a shard iterator using the ShardIterator parameter. The shard iterator specifies the position in the shard from which you want to start reading stream records sequentially. If there are no stream records available in the

https://api.apis.guru/v2/specs/amazonaws.com/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.GetRecords

Hover any highlighted part to learn what it does

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

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-Amz-Target': 'DynamoDBStreams_20120810.GetRecords'
  },
}); 
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/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.GetRecords"
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("X-Amz-Target", "DynamoDBStreams_20120810.GetRecords")

	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/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.GetRecords")

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

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

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

Returns a shard iterator. A shard iterator provides information about how to retrieve the stream records from within a shard. Use the shard iterator in a subsequent GetRecords request to read the stream records from the shard. A shard iterator expires 15 minutes after i

https://api.apis.guru/v2/specs/amazonaws.com/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.GetShardIterator

Hover any highlighted part to learn what it does

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

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-Amz-Target': 'DynamoDBStreams_20120810.GetShardIterator'
  },
}); 
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/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.GetShardIterator"
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("X-Amz-Target", "DynamoDBStreams_20120810.GetShardIterator")

	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/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.GetShardIterator")

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

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

res = http.request(req)
puts JSON.parse(res.body)
<?php
$url = "https://api.apis.guru/v2/specs/amazonaws.com/streams.dynamodb/2012-08-10/#X-Amz-Target=DynamoDBStreams_20120810.GetShardIterator";
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "X-Amz-Target: DynamoDBStreams_20120810.GetShardIterator"
    ]),
]];
$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 Amazon DynamoDB Streams?

Amazon DynamoDB Streams 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. Amazon DynamoDB Streams 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 ↗