Get Import Job
Poll an async batch import job for status, progress and — once completed — the merged result. Requires the job kind’s read scope (articles:read, suppliers:read or orders:read; the corresponding write scope implies it). Poll every ~2 s and back off for large jobs; completed and failed are terminal. An unknown job id and another company’s job id both return the same 404.
Authorizations
API key generated in Settings > API Keys. Include as Authorization: Bearer <key>.
Path Parameters
Job id returned by the batch POST (also in its Location header)
Response
The import job
Async batch import job. completed and failed are terminal — stop polling. The staged input payload is freed ~24 h after the job finishes and the job row itself is deleted ~30 days after creation; poll and persist the result within that window.
articles, suppliers, orders queued, running, completed, failed Entity-native merged batch result, present once status is completed. Orders additionally carry skippedOrders and autoCreated; articles carry skippedRows; suppliers carry inferredCountryCount.
Stable machine key when status is failed — e.g. workerError, dispatchFailed, or a JSON string for structured failures: {"key":"lineReplacementRequired","orderNumbers":[…]} or {"key":"invalidPayload","issues":[{"path","code"}]}. Never contains payload values.