Skip to main content

Create Next Report Request

POST 
/api/amazon/:integrationInstance/report-requests/create-next

Create the next pending report request for a report type on this integration instance. Computes the next data window — from the last synced data point up to the newest safe end time (Amazon report data is delayed by up to 72 hours depending on report type) — and stores a report request row without calling Amazon yet. Submit it with the Create Report from Request endpoint. If an identical pending request already exists it is returned instead of creating a duplicate. Report types with long windows are split into multiple requests; the first created request is returned.

Authorization

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

Body fields:

  • reportType (string, required) — one of: GET_MERCHANT_LISTINGS_ALL_DATA, GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA, GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL, GET_FBA_FULFILLMENT_REMOVAL_SHIPMENT_DETAIL_DATA, GET_FBA_FULFILLMENT_REMOVAL_ORDER_DETAIL_DATA, GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA, GET_LEDGER_SUMMARY_VIEW_DATA, GET_LEDGER_DETAIL_VIEW_DATA, GET_RESTOCK_INVENTORY_RECOMMENDATIONS_REPORT, GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE_V2, GET_SELLER_FEEDBACK_DATA, GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA, GET_FLAT_FILE_RETURNS_DATA_BY_RETURN_DATE, GET_FBA_REIMBURSEMENTS_DATA, GET_FBA_STORAGE_FEE_CHARGES_DATA, GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA.

Returns the stored report request (dataStartTime/dataEndTime in UTC ISO 8601; options and marketplaceIds are derived from the report type and instance). Fails when another report of the same type is still being processed (settlement and shipment reports excepted; stuck reports older than 4 hours are automatically failed so the request can proceed). Returns 422 for an unknown report type.

Request​

Responses​

OK

Response Headers
    Content-Type