Overview

Amazon has launched the Finances API version 2024‑06‑19, delivering financial event data to sellers almost as soon as the events are posted. The new release enables developers to request transaction details for a single order or any custom date range without waiting for the monthly statement cycle to close. Sellers who adopt the updated API can reconcile payouts, fees, and refunds much more quickly, giving them clearer cash‑flow insight.

Key Points

• Immediate event retrieval — Developers can pull financial events for a specific order ID or a defined date window the moment Amazon records them, instead of waiting for the end‑of‑month statement.
• Dual date filters — The API now supports both postedAfter and postedBefore parameters, allowing precise queries such as “all events from 2024‑03‑01 to 2024‑03‑15.”
• Streamlined pagination — Responses include a nextToken field that lets callers paginate through large result sets without losing continuity, useful when extracting a full month of activity.
• More descriptive errors — New error codes separate authentication problems, missing required fields, and rate‑limit violations, making troubleshooting faster for developers.
• Compatibility preserved — Existing integrations built on earlier versions keep working, but Amazon advises migrating to v2024‑06‑19 to take advantage of the enhancements.

How Finances API Works

1. Authentication — The seller’s software obtains a Login With Amazon (LWA) access token and signs each request with AWS Signature 4. Example: A third‑party inventory manager exchanges its client ID and secret for a token, then places the token in the Authorization header of every API call.
2. Building the request — Developers craft a GET request to the /finances/v0/financialEvents endpoint, adding query strings such as orderId=123‑4567890‑111213 or postedAfter=2024-04-01T00:00:00Z. : To retrieve events for order 123‑4567890‑111213, the full URL becomes .