> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get import status

> Check a template import started with the Nedzo REST API: its status, progress, the items it created, and why it failed.

> [!NOTE]
>
> This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](https://docs.nedzo.ai/api-reference/introduction.md#plan-access).

Check an import you started with [Import template](https://docs.nedzo.ai/api-reference/templates/import.md). Call it until `status` is `completed` or `failed`.

The import already names its workspace, so this call takes no `workspaceId`.

## Path Parameters

**importId** `string` *required*

The `importId` that [Import template](https://docs.nedzo.ai/api-reference/templates/import.md) returned.

## Response

**importId** `string`

The import.

**templateId** `string`

The template being imported.

**workspaceId** `string`

The workspace the template goes into.

**status** `string`

`queued`, `validating`, `creating_entities`, `remapping_refs`, `completed` or `failed`. The import is done at `completed` or `failed`.

**progress** `integer`

Rough progress in percent: `0` when queued, `10` while validating, `40` while creating items, `80` while linking them, `100` when completed. Not sent on a failed import.

**itemsCreated** `object`

How many items the import created: `agents`, `workflows`, `customFields` and `tags`. `workflowId` is the new workflow, when a workflow template made one. Sent once the import has completed.

**error** `object`

Why the import failed: a `code` and a fixed `message`. Sent only when `status` is `failed`.

**startedAt** `string`

When the work started, or `null`.

**completedAt** `string`

When the import completed or failed, or `null`.

## Error codes

| `code` | `message` |
| - | - |
| `TEMPLATE_NOT_FOUND` | `The template was not found.` |
| `SNAPSHOT_DECOMPRESSION_FAILED` | `The template content could not be read.` |
| `ENTITY_CREATION_FAILED` | `The import could not create the items in the workspace.` |
| `REFERENCE_REMAPPING_FAILED` | `The import could not link the new items to each other.` |
| `FINALIZATION_FAILED` | `The items were created but the import could not finish.` |
| `IMPORT_TIMEOUT` | `The import took too long and was stopped.` |
| `WORKFLOWS_NOT_ON_PLAN` | `The template has workflows and your plan does not include workflows.` |
| `QUEUE_ERROR` | `The import could not be started. Try again.` |
| `UNKNOWN_ERROR` | `The import failed.` |

## Errors

| Status | When |
| - | - |
| `400` | `importId` is not a UUID. |
| `403` | Your plan does not include this API, or your access token can't reach the import's workspace. |
| `404` | `Import not found`. No import has this ID, it belongs to another account, or its workspace was deleted. |

```bash cURL theme={null}
curl -X GET "https://api.nedzo.ai/v1/templates/imports/abc12345-e89b-12d3-a456-426614174000" \
    -H "Authorization: Bearer YOUR_API_KEY"
```

```json Completed theme={null}
{
  "importId": "abc12345-e89b-12d3-a456-426614174000",
  "templateId": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
  "status": "completed",
  "progress": 100,
  "itemsCreated": {
    "agents": 1,
    "workflows": 0,
    "customFields": 0,
    "tags": 0
  },
  "startedAt": "2026-11-15T10:00:00.000Z",
  "completedAt": "2026-11-15T10:00:30.000Z"
}
```

```json Failed theme={null}
{
  "importId": "abc12345-e89b-12d3-a456-426614174000",
  "templateId": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "789e4567-e89b-12d3-a456-426614174000",
  "status": "failed",
  "error": {
    "code": "ENTITY_CREATION_FAILED",
    "message": "The import could not create the items in the workspace."
  },
  "startedAt": "2026-11-15T10:00:00.000Z",
  "completedAt": "2026-11-15T10:00:12.000Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.