Get a single migration job by ID
Returns the full job record for a single bulk-import migration job, including status,
record counts (processed, succeeded, failed), and the complete structured errors array
for any records that failed validation or insertion. Requires migration:read scope.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Response
Migration job
Async bulk import job status record
migration_job Resource type (accounts, products, orders, journal-entries, vendor-bills, ap-payments, product-categories, product-variants, product-pricing-policies, product-vendors, product-prepackaged-presets, customer-payments, inventory-balances-opening-stock, inventory-balances-set-opening-stock, inventory-transactions, inventory-movements, order-tax-lines, account-addresses, account-contacts, purchase-orders, returns, vendor-credits)
pending, running, completed, failed, partial How to handle a record whose (external_source, external_id) already exists in Arcus.
- skip: leave the existing record unchanged, count as success
- update: call the canonical UPDATE handler with the incoming payload
- replace: NULL out the existing record's provenance UNIQUE, then INSERT new record
- error: abort the entire batch on the first collision (default if not specified: skip)
skip, update, replace, error Source system identifier (e.g. "versa", "shopify", "quickbooks")

