---
title: "Get the information on any import"
method: GET
path: "/crm/imports/2026-03/{importId}"
tags: ["Basic"]
---

# Get the information on any import

`GET /crm/imports/2026-03/{importId}`

## Request

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

A complete summary of an import record, including any updates.

## Path parameters

- `importId` integer, required

## Response `200`

successful operation

- PublicImportResponse
  - `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-06-15** (2026-03) `9e292cea2404`: 2 breaking, 24 warning
  - the `mappedObjectTypeIds/items/` response's property type changed from `object` to `string` for status `200`
  - the `metadata/objectLists/items/objectType` response's property type changed from `object` to `string` for status `200`
  - removed the optional property `mappedObjectTypeIds/items/hubSpotDefinedEventType` from the response with the `200` status
  - removed the optional property `mappedObjectTypeIds/items/hubSpotDefinedObjectType` from the response with the `200` status
  - …22 more
- **2026-06-15** (2026-03) `18a00a1b4dd7`: 2 breaking, 24 info
  - the `mappedObjectTypeIds/items/` response's property type changed from `string` to `object` for status `200`
  - the `metadata/objectLists/items/objectType` response's property type changed from `string` to `object` for status `200`
  - added the optional property `mappedObjectTypeIds/items/hubSpotDefinedEventType` to the response with the `200` status
  - added the optional property `mappedObjectTypeIds/items/hubSpotDefinedObjectType` to the response with the `200` status
  - …22 more
- **2026-05-22** (2026-03) `5447829df914`: 2 info
  - the security scope `crm.import` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm-import-read` was removed from the endpoint's security scheme `oauth2`
- …earlier changes not shown

[Operation history](https://skmtc.dev/hubspot/apis/crm-imports/changes/crm/imports/2026-03/:importId/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/77773fa56d67?raw)