---
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}`

This method retrieves a single import, including the current status of each asset in the import.

## Path parameters

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

## Headers

- `x-api-key` string, required

## Response `200`

The import has been successfully retrieved.

- ImportDetail — An import, including the current status of the asset for each file. Each time you retrieve the import, the platform recomputes these statuses from the current status of each 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 creating the connection, copied when the import was created. Present only when a value is set for the `custom_id` field.
  - `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 in the Retrieve an import response, 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 imported file, with the current status of its asset.
    - `source_id` string — The identifier of the file at the provider. For Google Drive, this is the Drive file identifier.
    - `asset_id` string — The unique identifier of the asset created for this 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. See the [Error codes](/v1.3/api-reference/error-codes) page for details. Possible values include `source_unavailable`, `source_not_authorized`, `unsupported_media_type`, `video_filesize_too_large`, `audio_filesize_too_large`, and `media_filesize_too_large`.
      - `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.

---

[API](https://skmtc.net/twelvelabs/apis/twelvelabs-api.md) · [All operations](https://skmtc.net/twelvelabs/apis/twelvelabs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvelabs/twelvelabs-api/versions/5dbd6e8473c9/schema)