---
title: "List imports"
method: GET
path: "/connections/{connection_id}/imports"
tags: ["imports"]
---

# List imports

`GET /connections/{connection_id}/imports`

This method returns a list of the imports for the specified connection. The platform returns the imports sorted by creation date, with the newest at the top of the list. Each import in the list is a summary and does not include the per-file details. To see them, use the [Retrieve an import](/v1.3/api-reference/data-connectors/imports/retrieve-an-import) endpoint.

## Path parameters

- `connection_id` string, required

## Query parameters

- `page` integer
- `page_limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

The imports have been successfully retrieved.

- ImportsListImportsResponse200
  - `data` Import[] — An array containing the imports.
    - `_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.
  - `page_info` PageInfo — An object that provides information about pagination.
    - `limit_per_page` integer — The maximum number of items on each page.
    - `page` integer — The page you retrieved.
    - `total_page` integer — The total number of pages.
    - `total_results` integer — The total number of results.

## Other responses

- `400` — The request has failed.
- `404` — The specified connection 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/revisions/fd9d80e384a8/schema)