Get Bulk Manage Preflight for Financial Event Groups
GET/api/amazon/unified/financial-event-groups/bulk-manage/preflight
Returns a read-only preview for the Bulk Manage Financial Event Groups action, without making any changes. Financial event groups are Amazon settlement (bank transaction) groupings used to generate accounting transactions in SKU.io.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
The response contains:
ready_groups_count- the number of financial event groups currently eligible ("ready") for accounting transaction generation.transactions- every existing accounting transaction linked to a financial event group (source_type=group) or to a settlement landed-cost bill (source_type=landed_cost_bill). Each entry includes the transaction type, total, reference, whether it is pushed to an external accounting integration (has_integration_link), and the Amazon financial event group identifier it belongs to (group_financial_event_group_id).
Use this preview to decide which transaction IDs to pass to POST /api/amazon/unified/financial-event-groups/bulk-manage and whether to regenerate afterwards. Runs synchronously.
Query parameters:
integration_instance_ids(optional) - comma-separated integration instance IDs to scope the preview.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.