finances_listFinancialEventGroups
List Amazon financial event groups (settlement periods).
readAmazon Seller (SP-API)sp.financesV0
Amazon SP-API · listFinancialEventGroups · GET /finances/v0/financialEventGroups Amazon op: listFinancialEventGroups (Finances v0). Read-only. Each group is a settlement period. Use its FinancialEventGroupId with finances_listFinancialEventsByGroupId to drill into a settlement's events.
Call it
In an AI client (MCP)
{
"name": "finances_listFinancialEventGroups",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/finances_listFinancialEventGroups \
-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. |
financialEventGroupStartedAfter | string · date-time | ISO 8601 date-time. Groups that started on or after this date. Defaults to ~last 30 days when both bounds are omitted (Amazon rejects an empty window). Must be more than two minutes before the request time. |
financialEventGroupStartedBefore | string · date-time | ISO 8601 date-time. Groups that started before (not at) this date. Must be after financialEventGroupStartedAfter and more than two minutes before the request time. A window wider than 180 days returns NO groups (an empty response, not an error) — page month by month. |
maxResultsPerPage | integer · 1–100 | groups per page, 1-100 (Amazon's default is 10 — pass 100 to page less). |
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.FinancialEventGroupList— array of groups, each with FinancialEventGroupId, ProcessingStatus (Open | Closed), FundTransferStatus, OriginalTotal, BeginningBalance, FinancialEventGroupStart / FinancialEventGroupEnd.data.nextToken— the cursor for the next page (null on the last page).