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

> List Amazon financial events (charges, credits, fees, etc.) by posted-date range.

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

MCP tool call:

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

Tool API (early access — contact us):

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

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

- `data.result.FinancialEvents` — event lists (ShipmentEventList, RefundEventList, ServiceFeeEventList, AdjustmentEventList, etc.).
- `data.nextToken` — the cursor for the next page (null on the last page).