---
title: "Retrieve an import"
method: GET
path: "/connections/{connection_id}/imports/{import_id}"
tags: ["imports"]
---

# Retrieve an import

`GET /connections/{connection_id}/imports/{import_id}`

## Request

- Base URL: `https://api.twelvelabs.io/v1.3`
- URL: `https://api.twelvelabs.io/v1.3/connections/{connection_id}/imports/{import_id}`
- Auth: API key in header `x-api-key`

This method retrieves a single import. For each file, the response includes the `action` field, which indicates the outcome of the import operation, and the `status` field, which reflects the current status of the asset each time you retrieve the import.

## Path parameters

- `connection_id` string, required
- `import_id` string, required

## Response `200`

The import has been successfully retrieved.

- ImportDetail: An import, including the `action` value and the current status of the asset for each file. Each time you retrieve the import, the `status` field of each item reflects the current status of its asset. The import itself does not change after it is created.
  - `_id` string: The unique identifier of the import.
  - `connection_id` string: The unique identifier of the connection the files were imported through.
  - `provider` 'google_drive': The data connector provider.
  - `custom_id` string: The label you supplied when you [authorized the connection](/v1.3/api-reference/data-connectors/authorize-a-connection), copied when the import was created. Present only when you supplied one.
  - `item_count` integer: The number of files requested in this import. If an imported asset is later deleted, it is omitted from the `items` array returned by the [Retrieve an import](/v1.3/api-reference/data-connectors/imports/retrieve-an-import) endpoint, so the `items` array can contain fewer entries than `item_count`.
  - `created_at` string, date-time: The date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the import was created.
  - `items` ImportItem[]: One entry per requested file, in request order, with its `action` value and the current status of its asset.
    - `source_id` string: The identifier of the file at the provider. For Google Drive, this is the identifier Google Drive assigns to the file.
    - `action` 'created' | 'skipped' | 'retried' | 'rejected': The action taken for this file: created, skipped, retried, or rejected. The platform sets this value while processing the request, and the value does not change afterward. The [Import files](/v1.3/api-reference/data-connectors/imports/import-files) endpoint always returns this field. The [Retrieve an import](/v1.3/api-reference/data-connectors/imports/retrieve-an-import) endpoint omits it for imports from before this field existed. Treat an absent value as unknown rather than as a specific action. The `skipped` and `retried` values both mean the file was already imported through this account: for the `skipped` action, the platform returns the existing asset; for the `retried` action, the earlier fetch had failed, so the platform fetches the file again. See [The import object](/v1.3/api-reference/data-connectors/imports/the-import-object#item-actions) for the meaning of each value.
    - `asset_id` string: The unique identifier of the asset for this file. When the `action` field is `created`, this identifies a new asset; when it is `skipped` or `retried`, this identifies the asset from the earlier import of the same file. Absent when the item was rejected before an asset was created.
    - `status` 'processing' | 'ready' | 'failed': The status of the asset. See [The import object](/v1.3/api-reference/data-connectors/imports/the-import-object#item-statuses) for the possible values. Absent when the item was rejected before an asset was created, in which case an `error` object is present.
    - `error` ImportItemError: Details of the rejection. Present when the item was rejected before an asset was created, in which case the `status` field is absent.
      - `code` string: A string representing the code associated with the error. For the possible values, see the [Error codes](/v1.3/api-reference/error-codes#the-connections-endpoints) page.
      - `message` string: A human-readable string describing the error, intended to be suitable for display in a user interface.

## Other responses

- `400`: The request has failed.
- `404`: The specified import does not exist.

## Changes

- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `x-api-key` was added to the API
- **2026-09-12** `6205c7327cde`: 1 info
  - api operation id `retrieve-import` removed and replaced with `imports_retrieve-import`
- **2026-08-18** `a332164b8c23`: 1 info
  - added the optional property `items/items/action` to the response with the `200` status
- **2026-07-31** `5dbd6e8473c9`: 1 warning
  - removed the optional property `docs_url` from the response with the `400` status
- **2026-07-26** `c0926990c662`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/connections/:connection_id/imports/:import_id/get.md)

---

[API](https://skmtc.dev/twelvelabs/apis/twelvelabs-api.md) - [All operations](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/revisions/c23c6e18fdd1?raw)