finances_listFinancialEvents
List Amazon financial events (charges, credits, fees, etc.) by posted-date range.
readAmazon Seller (SP-API)sp.financesV0
Amazon SP-API · listFinancialEvents · GET /finances/v0/financialEvents Amazon op: listFinancialEvents (Finances v0). Read-only. Events come grouped by type (ShipmentEventList, RefundEventList, …); for deferred/released status or a per-transaction breakdown use finances_listTransactions, and for settlement-level analysis finances_listFinancialEventGroups.
Call it
In an AI client (MCP)
{
"name": "finances_listFinancialEvents",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/finances_listFinancialEvents \
-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'). The response includes events posted on or after this date. Must be more than two minutes before the request time. |
postedBefore | string · date-time | ISO 8601 date-time. Events posted before (not on) this date. MUST be sent together with postedAfter — Amazon rejects postedBefore on its own. 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. |
maxResultsPerPage | integer · 1–100 | Max events per page (Amazon allows 1-100). |
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.FinancialEvents— event lists (ShipmentEventList, RefundEventList, ServiceFeeEventList, AdjustmentEventList, etc.).data.nextToken— the cursor for the next page (null on the last page).