List Contact Imports

GET

contacts

imports

Node.js

import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.contacts.imports.list({
  limit: 10,
  status: 'completed',
});

PHP

$resend = Resend::client('re_xxxxxxxxx');

$resend->contacts->imports->list([
  'limit' => 10,
  'status' => 'completed',
]);

Python

import resend

resend.api_key = "re_xxxxxxxxx"

params: resend.Contacts.Imports.ListParams = {
    "limit": 10,
    "status": "completed",
}

resend.Contacts.Imports.list(params)

Ruby

require "resend"

Resend.api_key = "re_xxxxxxxxx"

Resend::Contacts::Imports.list(limit: 10, status: "completed")

package main

import "github.com/resend/resend-go/v4"

func main() {
	client := resend.NewClient("re_xxxxxxxxx")

	limit := 10
	client.Contacts.Imports.List(&resend.ListContactImportsOptions{
		Limit:  &limit,
		Status: string(resend.ContactImportStatusCompleted),
	})
}

Rust

use resend_rs::{Resend, Result, Value, list_opts::ListOptions};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _data = resend
    .contacts
    .list_imports(
      ListOptions::default()
        .with_limit(10)
        .with_other("status", Value::String("completed".to_owned())),
    )
    .await?;

  Ok(())
}

Java

import com.resend.Resend;
import com.resend.services.contacts.model.ListContactImportsParams;
import com.resend.services.contacts.model.ListContactImportsResponseSuccess;

public class Main {
    public static void main(String[] args) throws Exception {
        Resend resend = new Resend("re_xxxxxxxxx");

        ListContactImportsParams params = ListContactImportsParams.builder()
                .limit(10)
                .status("completed")
                .build();

        ListContactImportsResponseSuccess data = resend.contacts().imports().list(params);
    }
}

cURL

curl -X GET 'https://api.resend.com/contacts/imports?limit=10&status=completed' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

CLI

resend contacts imports list --limit 10 --status completed

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "contact_import",
      "id": "479e3145-dd38-476b-932c-529ceb705947",
      "status": "completed",
      "created_at": "2026-05-15 18:32:37.823+00",
      "completed_at": "2026-05-15 18:33:42.916+00",
      "counts": {
        "total": 1200,
        "created": 800,
        "updated": 300,
        "skipped": 75,
        "failed": 25
      }
    }
  ]
}

Query Parameters

number

Number of contact imports to retrieve.

Default value: 10
Maximum value: 100
Minimum value: 1

string

The contact import ID after which we’ll retrieve more contact imports. This ID will not be included in the returned list. Cannot be used with the before parameter.

string

The contact import ID before which we’ll retrieve more contact imports. This ID will not be included in the returned list. Cannot be used with the after parameter.

'queued' | 'in_progress' | 'completed' | 'failed'

Filter contact imports by status.

Node.js

import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.contacts.imports.list({
  limit: 10,
  status: 'completed',
});

PHP

$resend = Resend::client('re_xxxxxxxxx');

$resend->contacts->imports->list([
  'limit' => 10,
  'status' => 'completed',
]);

Python

import resend

resend.api_key = "re_xxxxxxxxx"

params: resend.Contacts.Imports.ListParams = {
    "limit": 10,
    "status": "completed",
}

resend.Contacts.Imports.list(params)

Ruby

require "resend"

Resend.api_key = "re_xxxxxxxxx"

Resend::Contacts::Imports.list(limit: 10, status: "completed")

package main

import "github.com/resend/resend-go/v4"

func main() {
	client := resend.NewClient("re_xxxxxxxxx")

	limit := 10
	client.Contacts.Imports.List(&resend.ListContactImportsOptions{
		Limit:  &limit,
		Status: string(resend.ContactImportStatusCompleted),
	})
}

Rust

use resend_rs::{Resend, Result, Value, list_opts::ListOptions};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _data = resend
    .contacts
    .list_imports(
      ListOptions::default()
        .with_limit(10)
        .with_other("status", Value::String("completed".to_owned())),
    )
    .await?;

  Ok(())
}

Java

import com.resend.Resend;
import com.resend.services.contacts.model.ListContactImportsParams;
import com.resend.services.contacts.model.ListContactImportsResponseSuccess;

public class Main {
    public static void main(String[] args) throws Exception {
        Resend resend = new Resend("re_xxxxxxxxx");

        ListContactImportsParams params = ListContactImportsParams.builder()
                .limit(10)
                .status("completed")
                .build();

        ListContactImportsResponseSuccess data = resend.contacts().imports().list(params);
    }
}

cURL

curl -X GET 'https://api.resend.com/contacts/imports?limit=10&status=completed' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

CLI

resend contacts imports list --limit 10 --status completed

JSON

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "contact_import",
      "id": "479e3145-dd38-476b-932c-529ceb705947",
      "status": "completed",
      "created_at": "2026-05-15 18:32:37.823+00",
      "completed_at": "2026-05-15 18:33:42.916+00",
      "counts": {
        "total": 1200,
        "created": 800,
        "updated": 300,
        "skipped": 75,
        "failed": 25
      }
    }
  ]
}

Was this page helpful?

⌘I