See the Promotions API Guides for prerequisites and the full upload lifecycle.

Summary

Returns the current status of a processing job. Used for both async job types — bulk uploads (bulk_promotion_upload) and single-promotion updates (single_promotion_update).

Usage scenario

Partner submitted an async job and wants to poll for terminal status and per-promotion results. Polling is optional — partners can rely on the bulk upload completing successfully without explicit confirmation, and should poll only when they need to confirm processing outcomes or inspect failures.

Business constraints

• Terminal statuses: completed, partial_success, failed.
• errors[] is aggregated by promotion_id — each entry lists the complete item_ids per error type rather than emitting one entry per item.

Operational constraints

• Rate limit: 60 requests per brand per minute, per job_id.
• Recommended polling pattern: exponential backoff starting at 5 s, capped at 60 s.