Fetch a single import by id. Returns 404 if it does not exist or belongs to an organization your credential cannot access.
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Narrow the request to one organization (Organization-Id selector).
Narrow the request to a connection's organization.
Narrow the request to a platform entity's organization.
Optional source to disambiguate an Entity-Id.
The unique identifier of the import.
Import id.
Organization the import belongs to.
Import source (a connector name, or IMPORT for a manual CSV upload).
TRANSACTIONS for a sales/purchase CSV, PRODUCT_UPDATES for a product bulk-update workbook.
TRANSACTIONSPRODUCT_UPDATESSALE or PURCHASE for the whole file. null when set per row instead (rows default to SALE).
SALEPURCHASEOriginal uploaded file name. null until known.
Import processing status.
NEWSUBMITTEDVIRUS_SCAN_FAILEDVALIDATION_SUBMITVALIDATINGVALIDATION_SUCCESSVALIDATION_FAILUREIMPORT_STARTEDIMPORTINGFAILURESUCCESSCANCELLEDCONFIRM_PENDINGTotal rows in the uploaded file. null until counted.
Rows successfully imported as transactions.
Rows skipped during import.
When the import was created.
When the import row last changed.
When submit-stage processing started. null until submitted.
When validation finished. null until it completes.
True when the validation error log was truncated (only the first errors were kept).
Rows that passed validation. null until validation completes.
Rows that failed validation. null until validation completes.
When row processing finished. null until it completes.
Rows processed so far. null when rows are not currently being processed.
Rows imported so far. null when rows are not currently being processed.
Rows that failed to import so far. null when rows are not currently being processed.
ALL or VALID_ONLY, once row processing has been requested. null before then.
Why the import failed. One of duplicate_content, virus_scan_failed, upload_unavailable, upload_size_mismatch, unsupported_file_type, invalid_workbook, validation_failed, import_failed. null unless the import failed. Clients must tolerate new values.
duplicate_contentvirus_scan_failedupload_unavailableupload_size_mismatchunsupported_file_typeinvalid_workbookvalidation_failedimport_failedPlain-language explanation of the failure, safe to show to a person. null when failureReason is null, or when it needs no more detail than the reason itself.
True when GET /imports/{importId}/error-file has a validation error file to return.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request failed validation.