---
title: "Retrieve a bulk import"
method: GET
path: "/v1/imports/{import_id}"
tags: ["Imports"]
---

# Retrieve a bulk import

`GET /v1/imports/{import_id}`

This endpoint returns information about an "import"—a CSV file containing a group of people or events you uploaded to using `v1/imports` endpoint. You can use this endpoint to check to status of imports, or find out how many rows you successfully imported from a CSV file.

## Path parameters

- `import_id` integer, required

## Response `200`

Returns an import payload.

- object
  - `import` object, required — Represents an import operation.
    - `id` integer — This is the `import_id` you'll use if you want to [lookup your import operation](/integrations/api/app/tag/imports/getImport/).
    - `created_at` integer — The date time when the referenced ID was created.
    - `updated_at` integer — The date time when the referenced ID was last updated.
    - `name` string — A friendly name for your import. This helps you identify your import.
    - `description` string — A helpful description that can help you find and recognize your import operation.
    - `rows_to_import` integer — The total number of importable rows we found in the CSV.
    - `rows_imported` integer — The number of rows we imported from the CSV.
    - `state` 'preprocessing' | 'preprocessed' | 'validating' | 'validated' | 'importing' | 'imported' | 'failed' | 'canceled' — The state of the import—whether your import is being processed, fully completed (`imported`), or if it failed.
    - `type` 'people' | 'event' | 'object' | 'relationship' — The type of import.
    - `identifier` 'id' | 'email' — The type of identifier you used to identify people in your CSV. Not applicable for object imports.
    - `data_to_process` 'all' | 'only_new' | 'only_existing' — Controls whether your import adds and updates all rows, adds only new rows, or updates only existing rows. Defaults to `all`. Event imports support only `all` and `only_existing`. Formerly called `people_to_process`.
    - `people_to_process` 'all' | 'only_new' | 'only_existing' — Returned for people and event imports, even if you imported using the field `data_to_process`. This field will be deprecated soon.
    - `object_type_id` string — The object type an object belongs to—like "Companies" or "Accounts". Only applies to object imports.
    - `error` string — If your import fails, this helps you understand why.
    - `error_export_id` integer — ID of the export containing errors for the import, which can retrieved via [the *Get an export* endpoint](/integrations/api/app/tag/exports/getExport/). Only present when there are errors.
    - `error_download_url` string — URL to download errors for the import via [the *Download an export* endpoint](/integrations/api/app/tag/exports/downloadExport/). Only present when there are errors.
    - `warning_export_id` integer — ID of the export containing warnings for the import, which can retrieved via [the *Get an export* endpoint](/integrations/api/app/tag/exports/getExport/). Only present when there are warnings.
    - `warning_download_url` string — URL to download warnings for the import via [the *Download an export* endpoint](/integrations/api/app/tag/exports/downloadExport/). Only present when there are warnings.

## Other responses

- `429` — Your request is over the 10-per-second limit. `Retry-After` tells you how many seconds you must wait before you send the next request.

## Changes

- **2026-09-02** `5da2740beeb5` — 1 info
  - added the media type `application/json` for the response with the status `429`

[Change history](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/changes/v1/imports/:import_id/get.md)

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/00b93971a49f/schema)