get_orders_report
Orders and units for an Amazon Seller account over a date range.
On this page
Endpoint
Orders and units for an Amazon Seller account over a date range.
The call shape is illustrative until the contract is final.
When to use it
Use it for revenue and units in a weekly card, a month-end export, or days of stock. Sales keep moving for up to 14 days, and Build re-pulls those days until they settle (to confirm).
Request fields
| Name | Type | Description |
|---|---|---|
| accountRequired | string | The account to read. A key only reaches the accounts you chose when you created it. |
| start | date | First day, as YYYY-MM-DD. |
| end | date | Last day, as YYYY-MM-DD. |
Response fields
Every answer says how fresh it is with data_as_of.
To write: the response fields of an orders row, and where settling_from appears
Examples
curl -X POST https://build-api.sellermate.ai/v1/tools/get_orders_report \
-H "X-API-Key: $BUILD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"account":"acct_123","start":"2026-10-01","end":"2026-10-28"}'To write: a real response with two or three rows
Errors
429 Too many requests
You went over the plan's requests per minute. The body says when to retry.
{ "error": "rate_limited", "retry": 12, "upgrade": "https://build.sellermate.ai/pricing" }
To write: the other errors this tool can return, with the real status and body: a missing or wrong key, an account the key cannot reach, bad dates
Platforms
Open in your AI
Paste this into Claude Code, Cursor, Lovable, n8n or Zapier. It points your AI at the docs and at your key.
Read https://build.sellermate.ai/SKILL.md. My key is in BUILD_API_KEY. Use get_orders_report to total last week’s orders and units by day.
Last updated 30 Oct 2026