Request Latest Aged Inventory Surcharge Report (Sync)
POST/api/amazon/unified/fba-longterm-storage-fees/sync
Request the FBA aged inventory surcharge / long-term storage fee report (GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA) from Amazon, backfilling from the instance's FBA inventory tracking start month forward. Per instance, only the next contiguous block of charge months with NO data yet is requested (a single report covers a multi-month window), so months already imported are never re-requested. When every month through the last completed month is already present, no report is requested and the response carries requested=false.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Scope with filter[integration_instance_ids] (comma-separated) or integration_instance_ids. Returns 409 if an aged inventory surcharge report is already in progress. Dispatches a tracked a background job per request (track via the tracked job log endpoints). Requires Bearer token.
Request
Responses
- 200
- 401
- 403
- 409
- 422
- 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.
Conflict
Response Headers
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
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.