Docs
Get Import
GET /imports/{importId}
GET
/imports/{importId}Required Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Re-reads a stored plan, so the wizard survives a refresh. After execute it also carries each row's actual result.
importId is set automatically by Create Import.
Requires EventAdmin permission on the event.
Response
| Field | Type | Description |
|---|---|---|
| importId | Guid | |
| target | string | |
| status | string | `Planned`, `Executing`, `Completed`, `Failed` or `Abandoned`. |
| fileName | string | |
| rowCount / createCount / updateCount / skipCount | int | Derived from the rows; never assigned. |
| plannedDate / executedDate | date| null | `executedDate` is null until execute. |
| rows[].rowNumber | int | The line number in the user's file. |
| rows[].plannedOutcome | string | `Create`, `Update` or `Skip`. Never mutated by execute. |
| rows[].matchedRecordId | Guid | The record this row will update, or the one it created. |
| rows[].matchedRecordLabel | string| null | What that record was called **when the plan was made**. Stored rather than looked up, so a rename does not rewrite the receipt. Null when nothing matched. |
| rows[].skipReason | string | `NotUnique`, `DuplicateInFile`, `ValidationFailed`, `MissingRequired` or `ExcludedByUser`. |
| rows[].reason | string | Human-readable prose. Survives the payload purge. |
| rows[].result | string| null | Null until execute, then `Created`, `Updated`, `Skipped` or `Failed`. |
| rows[].resolvedValues | object | Cell values keyed by attribute key. |
plannedOutcome and result are separate fields and are allowed to disagree — the
disagreement is the audit record of a plan that drifted before it was committed.
The two duplicate skip reasons are never interchangeable
skipReason | What went wrong | Where the fix is |
|---|---|---|
NotUnique | The key matched two or more existing records | In BackOps — the data is genuinely ambiguous |
DuplicateInFile | The key appears twice in the uploaded file | In the spreadsheet |
Every row sharing an in-file duplicate key is skipped, not just the later ones. Keeping the first would pick a winner silently when the rows disagree.
Errors
| Status | Meaning |
|---|---|
404 | No such import, or it belongs to another event or organization. |