finances_listFinancialEventsByGroupId
List all financial events for a specific settlement group.
readAmazon Seller (SP-API)sp.financesV0
Amazon SP-API · listFinancialEventsByGroupId · GET /finances/v0/financialEventGroups/{eventGroupId}/financialEvents Amazon op: listFinancialEventsByGroupId (Finances v0). Read-only. Use after finances_listFinancialEventGroups to drill into one settlement.
Call it
In an AI client (MCP)
{
"name": "finances_listFinancialEventsByGroupId",
"arguments": {
"store": "myStore-US",
"groupId": "<groupId>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/finances_listFinancialEventsByGroupId \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","groupId":"<groupId>"}'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. |
groupIdrequired | string | FinancialEventGroupId from finances_listFinancialEventGroups (maps to the eventGroupId path param). |
postedAfter | string · date-time | optional ISO 8601 date-time. Scope the group's events to those posted on or after this date. Must be more than two minutes before the request time. |
postedBefore | string · date-time | optional ISO 8601 date-time. 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.groupId— the requested group ID.data.result.FinancialEvents— detailed event lists for this settlement (same shape as finances_listFinancialEvents).data.nextToken— the cursor for the next page (null on the last page).