finances_listTransactions
List Amazon financial transactions by posted-date range.
readAmazon Seller (SP-API)sp.finances_2024-06-19
Amazon SP-API · listTransactions · GET /finances/2024-06-19/transactions Amazon op: listTransactions (Finances 2024-06-19, served at /finances/2024-06-19/transactions — NOT the v0 events API). Read-only. Each transaction carries transactionType, transactionStatus, totalAmount, postedDate, items, contexts, and breakdowns — useful for detailed reconciliation. Use it for deferred/released status (DEFERRED_RELEASED) and one row per transaction with breakdowns; use finances_listFinancialEvents for the v0 event lists by type.
Call it
In an AI client (MCP)
{
"name": "finances_listTransactions",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/finances_listTransactions \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
postedAfter | string · date-time | ISO 8601 date-time (e.g. '2026-01-01T00:00:00Z'). Transactions posted on or after this date. REQUIRED by Amazon unless you pass relatedIdentifierName + relatedIdentifierValue. Must be more than two minutes before the request time. When you pass neither a window nor a related identifier the server defaults it to ~30 days ago. |
postedBefore | string · date-time | ISO 8601 date-time. Posted before (not on) this date. Must be later than postedAfter and more than two minutes before the request time. A window wider than 180 days returns an EMPTY response (not an error) — page month by month. Default when omitted: two minutes before the request. |
transactionStatus | string | optional filter. Allowed: DEFERRED (currently deferred) | RELEASED (currently released) | DEFERRED_RELEASED (was deferred, now released). |
relatedIdentifierName | string | optional. Filter by a related identifier; must be sent together with relatedIdentifierValue. Allowed: FINANCIAL_EVENT_GROUP_ID (the settlement group ID) | ORDER_ID (the Amazon order ID). |
relatedIdentifierValue | string | optional. The value matching relatedIdentifierName (e.g. the group ID or order ID string). |
nextToken | string | the cursor from the previous call's data.nextToken; omit for the first page. Send it with the same other arguments. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.result.transactions— array of transactions — each with transactionId, transactionType, transactionStatus, description, postedDate, totalAmount {currencyCode, currencyAmount}, marketplaceDetails, sellingPartnerMetadata, items, contexts, breakdowns[].data.nextToken— the cursor for the next page (null on the last page).