# finances_listFinancialEventsByGroupId (https://sellersheetai.com/docs/mcp-api/tools/finances_listFinancialEventsByGroupId)

> List all financial events for a specific settlement group.

Access: **READ** · toolset amazon_sp · family 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

MCP tool call:

```json
{
  "name": "finances_listFinancialEventsByGroupId",
  "arguments": {
    "store": "myStore-US",
    "groupId": "<groupId>"
  }
}
```

Tool API (early access — contact us):

```bash
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>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `store` | string | yes | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
| `groupId` | string | yes | 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

- `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).