Track orders

Triage today's orders and answer a buyer in one ask — and leave history and totals to your synced order data, which answers instantly.

In short

Two live tools cover order tracking: search across orders, then drill into one. For history and totals, your synced order data answers at once, with no call to Amazon.

In your daily workflow

Morning check

"Any unshipped orders?" orders_searchOrders filters by fulfillment status and date, so you triage pending, unshipped or cancelled orders in one ask.

A buyer writes in

Paste the order ID. orders_getOrder returns that one order in full — status, items, shipping service, tracking — everything you need to answer the message.

"How did last month do?"

That is not an Orders-API question. Your orders sync into the warehouse continuously, and query_report_data answers revenue, units and repeat-buyer questions over any date range at once. See Synced reports.

"Where is the money for this order?"

finances_listFinancialEventsByOrderId itemizes the charges, fees and refunds behind one order. See Financial reports.

Try asking

"Show me unshipped orders from the last 7 days for myStore-US."

"What's the status of order 111-1234567-1234567?"

The search, both ways

The same tool and the same arguments — through your AI client, or from your own code.

MCP — you ask for unshipped orders; your agent calls orders_searchOrders with a status filter and a date range, pages through the results, and can write the list to your sheet to work through.

In an AI client (MCP)

tools/call
{
  "name": "orders_searchOrders",
  "arguments": {
    "store": "myStore-US",
    "created_after": "2026-10-11T00:00:00Z",
    "fulfillment_statuses": [
      "UNSHIPPED",
      "PARTIALLY_SHIPPED"
    ]
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/orders_searchOrders \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","created_after":"2026-10-11T00:00:00Z","fulfillment_statuses":["UNSHIPPED","PARTIALLY_SHIPPED"]}'
Early access — the Tool API is open on request, contact us.

Tools on this page

Pulled from the catalog at build time, each with its own access label.

ToolAccessWhat it does
orders_searchOrdersreadSearch orders (Orders v2026-01-01): ONE Amazon page plus data.nextToken, the full v2026 filter set, and line items INLINE on each order (order.orderItems) — no separate items call.
orders_getOrderreadGet one order (Orders v2026-01-01) with its line items inline (order.orderItems) and any included_data expansions.
query_report_datareadQuery the synced report warehouse (rpt_* tables) — rows without calling Amazon.
finances_listFinancialEventsByOrderIdreadGet all financial events for a specific Amazon order ID.

FAQ

Do orders show the buyer's name and address?

No. SellerSheet does not hold Amazon's restricted-data role, so an order shows at most the delivery city, country and postal code. See Data we never see.

Live or synced?

Live Orders tools for today's operational questions; synced data for anything historical or aggregated — it is faster and does not use Amazon's rate limits. For totals by period, also see Sales analytics.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude