Get Report Status
GET/api/amazon/unified/reports/:reportId/status
Returns the current lifecycle status of an Amazon SP-API report record for progress monitoring/polling.
Any valid API token can call this endpoint — no specific scope required. Manage tokens.
Side effect: before responding, SKU.io attempts to sync the report record from Amazon so the returned state is current (best-effort - if the Amazon call fails, the stored state is returned).
Response data fields:
status- one ofpending,in_progress,retrying,downloading,processing,completed,cancelled,failed.message- human-readable progress message (includes the Amazon report ID when assigned).progress- 0-100 progress indicator.processing_status- raw Amazon processing status (IN_QUEUE,IN_PROGRESS,DONE,CANCELLED,FATAL, or the internalRETRY).has_raw_data- whether the report file has been downloaded.is_processed- whether the report data has been imported into SKU.io.created_time,processed_at- ISO 8601 timestamps (nullable).
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Not Found
Response Headers
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.