Skip to main content

Get Report Schedule (Next Run)

GET 
/api/amazon/unified/fba-storage-fees/schedule

Report-pipeline status for the daily FBA storage fee and aged-inventory surcharge report requests, powering the always-visible status strip on each report page. Scoped to the selected (FBA-enabled) integration instances via the optional integration_instance_ids filter.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

For each report type (storage_fee, aged_inventory_surcharge) the response returns:

  • cron / next_run — the configured cron and next scheduled run (absolute ISO 8601), for the live countdown.
  • state — one of in_progress, failed, idle (up to date / healthy), never_run.
  • looks_stuck (bool) — true when an in-progress run has been pending longer than stuck_threshold_hours.
  • stuck_threshold_hours (int) — hours after which an in-progress run is flagged as stuck.
  • in_progress_since (ISO 8601|null) — when the oldest in-flight run was requested.
  • last_success_at (ISO 8601|null) — when the last report was successfully imported.
  • last_failure_at (ISO 8601|null) — when the last run failed (FATAL), if the most recent run failed.
  • data_through_month (YYYY-MM|null) — latest charge month the imported data covers.
  • expected_through_month (YYYY-MM) — the most recent charge month Amazon has finalised, which the data is expected to cover. Amazon finalises a month's storage fees between the 7th and 15th of the following month (the aged-inventory surcharge is assessed on the 15th), so before the monthly report_ready_day this is the month before last; on/after it, the previous calendar month.
  • awaiting_month (YYYY-MM|null) — the latest calendar month still pending Amazon's mid-month finalisation and not yet imported, or null when nothing is awaited. When set, the pipeline is correctly waiting on Amazon (not behind); the report is auto-requested once that month becomes ready.
  • report_ready_day (int) — day of the month (default 16) from which the previous month's data is expected and requested.
  • is_behind (bool) — true when data_through_month is older than expected_through_month.
  • instance_count (int) — number of FBA-enabled instances in scope.

Authentication: Requires a Bearer token (Personal Access Token).

Request​

Responses​

OK

Response Headers
    Content-Type