# get_orders_report

> Orders and units for an Amazon Seller account over a date range.

## Endpoint

POST https://build-api.sellermate.ai/v1/tools/get_orders_report — Orders and units for an Amazon Seller account over a date range. (writes: no; platforms: Amazon)

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 | Required | Description |
|---|---|---|---|
| `account` | string | yes | The account to read. A key only reaches the accounts you chose when you created it. |
| `start` | date | no | First day, as `YYYY-MM-DD`. |
| `end` | date | no | 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**

```bash
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"}'
```

**Node**

```js
const res = await fetch("https://build-api.sellermate.ai/v1/tools/get_orders_report", {
  method: "POST",
  headers: { "X-API-Key": process.env.BUILD_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ account: "acct_123", start: "2026-10-01", end: "2026-10-28" }),
});
console.log(await res.json());
```

**Python**

```python
import os, requests

res = requests.post(
    "https://build-api.sellermate.ai/v1/tools/get_orders_report",
    headers={"X-API-Key": os.environ["BUILD_API_KEY"]},
    json={"account": "acct_123", "start": "2026-10-01", "end": "2026-10-28"},
)
print(res.json())
```

_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.

```json
{ "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

- Amazon: Reads: yes · Writes: yes

## 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.

Prompt:

```
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.
```