---
title: "List all Importers"
method: GET
path: "/importers"
tags: ["importers"]
---

# List all Importers

`GET /importers`

## Request

- Base URL: `https://api.withpersona.com/api/v1`
- URL: `https://api.withpersona.com/api/v1/importers`
- Auth: HTTP bearer

Returns a list of your organization's importers. Results are returned in reverse chronological order, with the most recently created objects first.

## Query parameters

- `page` ImportersGetParametersPage
  - `after` string: Object ID for pagination cursor
  - `before` string: Object ID for pagination cursor
  - `size` number, double: Limit on the number of objects returned
- `fields` object

## Headers

- `Key-Inflection` 'camel' | 'kebab' | 'snake'
- `Idempotency-Key` string
- `Persona-Version` '2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18': Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).

## Response `200`

This endpoint returns an Importer object.

- ImportersListAllImportersResponse200
  - `data` Importer[], required: An array of Importers
    - union
      - object: An Importer for Accounts
        - `type` 'importer/account', required: Discriminator value: importer/account
        - `id` string: Unique identifier for this Importer. Starts with `mprt_`.
        - `attributes` ImporterSharedAttributes
          - `completed-at` string, date-time, nullable
          - `created-at` string
          - `duplicate-count` integer
          - `error-count` integer
          - `status` string: Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
          - `successful-count` integer
      - object: An Importer for email address List Items
        - `type` 'importer/list-item/email-address', required: Discriminator value: importer/list-item/email-address
        - `id` string: Unique identifier for this Importer. Starts with `mprt_`.
        - `attributes` ImporterSharedAttributes
          - `completed-at` string, date-time, nullable
          - `created-at` string
          - `duplicate-count` integer
          - `error-count` integer
          - `status` string: Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
          - `successful-count` integer
      - object: An Importer for face List Items IMPORTANT: You must ensure proper consent for processing of biometrics is in place prior to using face Lists.
        - `type` 'importer/list-item/face', required: Discriminator value: importer/list-item/face
        - `id` string: Unique identifier for this Importer. Starts with `mprt_`.
        - `attributes` ImporterSharedAttributes
          - `completed-at` string, date-time, nullable
          - `created-at` string
          - `duplicate-count` integer
          - `error-count` integer
          - `status` string: Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
          - `successful-count` integer
      - object: An Importer for field List Items
        - `type` 'importer/list-item/field', required: Discriminator value: importer/list-item/field
        - `id` string: Unique identifier for this Importer. Starts with `mprt_`.
        - `attributes` ImporterSharedAttributes
          - `completed-at` string, date-time, nullable
          - `created-at` string
          - `duplicate-count` integer
          - `error-count` integer
          - `status` string: Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
          - `successful-count` integer
      - object: An Importer for geolocation List Items
        - `type` 'importer/list-item/geolocation', required: Discriminator value: importer/list-item/geolocation
        - `id` string: Unique identifier for this Importer. Starts with `mprt_`.
        - `attributes` ImporterSharedAttributes
          - `completed-at` string, date-time, nullable
          - `created-at` string
          - `duplicate-count` integer
          - `error-count` integer
          - `status` string: Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
          - `successful-count` integer
      - object: An Importer for government ID number List Items
        - `type` 'importer/list-item/government-id-number', required: Discriminator value: importer/list-item/government-id-number
        - `id` string: Unique identifier for this Importer. Starts with `mprt_`.
        - `attributes` ImporterSharedAttributes
          - `completed-at` string, date-time, nullable
          - `created-at` string
          - `duplicate-count` integer
          - `error-count` integer
          - `status` string: Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
          - `successful-count` integer
      - object: An Importer for IP address List Items
        - `type` 'importer/list-item/ip-address', required: Discriminator value: importer/list-item/ip-address
        - `id` string: Unique identifier for this Importer. Starts with `mprt_`.
        - `attributes` ImporterSharedAttributes
          - `completed-at` string, date-time, nullable
          - `created-at` string
          - `duplicate-count` integer
          - `error-count` integer
          - `status` string: Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
          - `successful-count` integer
      - object: An Importer for name List Items
        - `type` 'importer/list-item/name', required: Discriminator value: importer/list-item/name
        - `id` string: Unique identifier for this Importer. Starts with `mprt_`.
        - `attributes` ImporterSharedAttributes
          - `completed-at` string, date-time, nullable
          - `created-at` string
          - `duplicate-count` integer
          - `error-count` integer
          - `status` string: Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
          - `successful-count` integer
      - object: An Importer for phone number List Items
        - `type` 'importer/list-item/phone-number', required: Discriminator value: importer/list-item/phone-number
        - `id` string: Unique identifier for this Importer. Starts with `mprt_`.
        - `attributes` ImporterSharedAttributes
          - `completed-at` string, date-time, nullable
          - `created-at` string
          - `duplicate-count` integer
          - `error-count` integer
          - `status` string: Possible values: - pending - ready - errored Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
          - `successful-count` integer
  - `links` ImportersGetResponsesContentApplicationJsonSchemaLinks, required
    - `prev` string, nullable, required
    - `next` string, nullable, required

## Other responses

- `400`: The request was unacceptable, often due to invalid parameters.
- `401`: An invalid API key was provided.
- `403`: The given API key doesn’t have permissions to perform the request or a quota has been exceeded.
- `429`: Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests.

---

[API](https://skmtc.dev/withpersona/apis/withpersona-7.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-7/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-7/revisions/904c4b28844f?raw)