---
title: "Import IP Address Lists"
method: POST
path: "/importer/list-item/ip-addresses"
tags: ["importers"]
---

# Import IP Address Lists

`POST /importer/list-item/ip-addresses`

## Request

- Base URL: `https://api.withpersona.com/api/v1`
- URL: `https://api.withpersona.com/api/v1/importer/list-item/ip-addresses`
- Auth: HTTP bearer

Bulk import IP address List Items by uploading a CSV file.

Each row should be the details for a new List Item. The columns we allow are:
  - value

Both IPv4 and IPv6 are supported.

## Query parameters

- `include` string
- `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).

## Request body `multipart/form-data`

- object
  - `data` ImporterListItemIpAddressesPostRequestBodyContentMultipartFormDataSchemaData, required
    - `attributes` ImporterListItemIpAddressesPostRequestBodyContentMultipartFormDataSchemaDataAttributes, required
      - `file` string, binary, required
      - `list-id` string, required

## Response `201`

This endpoint returns an Importer object.

- ImportersImportIpAddressListsResponse201
  - `data` ImporterListItemIpAddress, required: An Importer for IP address List Items
    - `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

## 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.
- `409`: The request conflicts with another request, often due to attempting to create a duplicate resource.
- `422`: The request modifies the resource in an unacceptable way, often due to an invalid action or parameter.
- `429`: Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests.

---

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