Overview

On 15 November 2023 Amazon opened the Data Kiosk API to the public as a beta‑stage service. The endpoint delivers a lean, on‑demand reporting experience that lets sellers request only the data fields they actually need, instead of downloading massive bulk files. Sellers who depend on up‑to‑the‑minute metrics should test the beta now to simplify their data pipelines and prepare for the forthcoming general‑availability release.

Key Points

• Beta launch date — The Data Kiosk API became publicly available on 15 Nov 2023, granting any qualified seller access without a private invitation.
• Field‑level selection — Calls can specify exact columns and record types, so the response contains just the requested attributes, cutting payload size dramatically.
• Unified security model — Authentication relies on the same AWS Signature 4 process used by all Selling Partner APIs, meaning existing IAM roles and tokens work without additional setup.
• Dedicated documentation — All request schemas, response formats, and error codes for the beta are grouped under a “Beta” tab in the Selling Partner API portal, keeping them separate from the stable GA docs.
• Visible throttling limits — Rate‑limit values appear in response headers, enabling client code to read the remaining quota and adjust request frequency in real time.
• Feedback mechanism — A feedback form embedded in the beta documentation page lets developers submit bugs or feature suggestions directly to the product team, influencing the final design.

How Data Kiosk API Works

1. Authentication handshake — The client builds a signed HTTP request using AWS Signature 4 and includes the x-amz-access-token obtained from the Login with Amazon flow. Example: An inventory‑management SaaS signs a GET request to /reports/v1/kiosk with its IAM role credentials; a valid token yields a 200 OK response.
2. Report definition payload — The request body carries a JSON object that enumerates the desired report categories (e.g., , ) and lists each field to be returned (e.g., , , ). : A seller asks for only and for orders placed in the previous 24 hours, deliberately omitting address and buyer‑contact fields.