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

> List Amazon financial event groups (settlement periods).

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

MCP tool call:

```json
{
  "name": "finances_listFinancialEventGroups",
  "arguments": {
    "store": "myStore-US"
  }
}
```

Tool API (early access — contact us):

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

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

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