---
title: "List Imports"
method: GET
path: "/import"
tags: ["Import"]
---

# List Imports

`GET /import`

Retrieve a list of imports

## Query parameters

- `id` string
- `created_at` string
- `updated_at` string
- `organisation_id` string
- `type` string
- `payload` string
- `contact_list_id` string
- `contact_list_external_id` string
- `failed_url` string
- `payload_url` string
- `total_count` string
- `success_count` string
- `failed_count` string
- `reference_id` string
- `hints` string
- `allow_deal_reassignment` string
- `allow_appointment_reassignment` string
- `select` string
- `order` string
- `offset` string
- `limit` string

## Headers

- `Range` string
- `Range-Unit` string

## Response `200`

OK

- Import[]
  - `id` string, uuid — Import ID
  - `created_at` string, timestamp with time zone — Import creation date
  - `updated_at` string, timestamp with time zone — Latest update
  - `organisation_id` string, uuid — Organisation ID
  - `type` 'contact_details' | 'deal_details' | 'appointment_details', public.import_type — Type of import
  - `payload` object, nullable — Payload of import for small imports
  - `contact_list_id` string, uuid, nullable — ID of the contact list that the contacts should be assigned to
  - `contact_list_external_id` string, text, nullable — External ID of the contact list that the contacts should be assigned to
  - `failed_url` string, text, nullable — URL to download the failed contacts
  - `payload_url` string, text, nullable — URL to download the payload for large imports
  - `total_count` integer, nullable — Total number of contacts in the import
  - `success_count` integer, nullable — Number of contacts successfully imported
  - `failed_count` integer, nullable — Number of contacts that failed to import
  - `reference_id` string, text, nullable — An optional reference ID provided during the import
  - `hints` object, nullable — Optional hints for the import, e.g. to indicate if a field was stolen from another contact. We only store the first 20 hints.
  - `allow_deal_reassignment` boolean, nullable — If true, a deal currently assigned to another contact will be re-assigned
  - `allow_appointment_reassignment` boolean, nullable — If true, an appointment currently assigned to another contact will be re-assigned

---

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