---
title: "List Imports"
method: GET
path: "/crm/imports/2026-09"
tags: ["Basic"]
---

# List Imports

`GET /crm/imports/2026-09`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/imports/2026-09`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.import`

Retrieve a list of imports in your HubSpot account. This endpoint allows you to view the imports that have been processed, providing details about each import. It supports pagination to navigate through large sets of import data.

## Query parameters

- `after` string
- `limit` integer

## Response `200`

successful operation

- CollectionResponsePublicImportResponseForwardPaging
  - `paging` ForwardPaging: Paging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: A string token used as a cursor to fetch the next set of results in a paginated response.
      - `link` string: A URL string that provides the link to the next page of results.
  - `results` PublicImportResponse[], required: An array of PublicImportResponse objects, each representing an individual import response.
    - `createdAt` string, date-time, required: The timestamp when the object was created, in ISO 8601 format.
    - `id` string, required: The unique identifier for this import.
    - `importName` string: The user-provided name for this import.
    - `importRequestJson` object: The complete import request configuration as a JSON object.
    - `importSource` 'API' | 'CRM_UI' | 'IMPORT' | 'MOBILE_ANDROID' | 'MOBILE_IOS' | 'SALESFORCE': Indicates where/how the import was initiated.
    - `importTemplate` ImportTemplate
      - `templateId` integer, required: The unique identifier for the specific saved template or previous import being referenced.
      - `templateType` 'admin_defined' | 'previous_import' | 'user_file', required: The classification of what type of template this represents, and what is its origin or purpose.
    - `mappedObjectTypeIds` string[], required: An array of object type IDs that are mapped during the import.
    - `metadata` PublicImportMetadata, required
      - `counters` object, required: Summarized outcomes of each row a developer attempted to import into HubSpot.
      - `fileIds` string[], required: The IDs of files uploaded in the File Manager API.
      - `objectLists` PublicObjectListRecord[], required: The lists containing the imported objects.
        - `listId` string, required: The ID of the list containing the imported objects.
        - `objectType` string, required: The type of object contained in the list.
    - `optOutImport` boolean, required: Whether or not the import is a list of people disqualified from receiving emails.
    - `state` 'CANCELED' | 'DEFERRED' | 'DONE' | 'FAILED' | 'PROCESSING' | 'REVERTED' | 'STARTED', required: The status of the import.
    - `updatedAt` string, date-time, required: The timestamp when the import record was last updated, formatted as an ISO 8601 instant.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-03** (2026-09) `8c1d8b465db8`: 1 breaking, 2 info
  - the `results/items/importTemplate/templateId` response's property format changed from `int32` to `int64` for status `200`
  - api operation id `get-/crm/imports/2026-09_/crm/imports/2026-09` removed and replaced with `get-/crm/imports/2026-09_/crm/imports/v3`
  - the endpoint scheme security `private_apps` was removed from the API

[Operation history](https://skmtc.dev/hubspot/apis/crm-imports/changes/crm/imports/2026-09/get.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-imports.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-imports/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-imports/revisions/447517f327fb?raw)