List Contact Imports
Retrieve a list of contact imports.
GET
/
contacts
/
imports
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.contacts.imports.list({
limit: 10,
status: 'completed',
});
$resend = Resend::client('re_xxxxxxxxx');
$resend->contacts->imports->list([
'limit' => 10,
'status' => 'completed',
]);
import resend
resend.api_key = "re_xxxxxxxxx"
params: resend.Contacts.Imports.ListParams = {
"limit": 10,
"status": "completed",
}
resend.Contacts.Imports.list(params)
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),
})
}
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(())
}
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 -X GET 'https://api.resend.com/contacts/imports?limit=10&status=completed' \
-H 'Authorization: Bearer re_xxxxxxxxx'
resend contacts imports list --limit 10 --status completed
{
"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
The contact import ID after which to retrieve more contact imports.
This ID won’t be included in the returned list. Can’t be used with
the
before parameter.The contact import ID before which to retrieve more contact imports.
This ID won’t be included in the returned list. Can’t be used with
the
after parameter.You can only use either
after or before parameter,
not both. See our pagination guide for
more information.import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.contacts.imports.list({
limit: 10,
status: 'completed',
});
$resend = Resend::client('re_xxxxxxxxx');
$resend->contacts->imports->list([
'limit' => 10,
'status' => 'completed',
]);
import resend
resend.api_key = "re_xxxxxxxxx"
params: resend.Contacts.Imports.ListParams = {
"limit": 10,
"status": "completed",
}
resend.Contacts.Imports.list(params)
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),
})
}
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(())
}
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 -X GET 'https://api.resend.com/contacts/imports?limit=10&status=completed' \
-H 'Authorization: Bearer re_xxxxxxxxx'
resend contacts imports list --limit 10 --status completed
{
"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
import { Resend } from 'resend';
const resend = new Resend('re_xxxxxxxxx');
const { data, error } = await resend.contacts.imports.list({
limit: 10,
status: 'completed',
});
$resend = Resend::client('re_xxxxxxxxx');
$resend->contacts->imports->list([
'limit' => 10,
'status' => 'completed',
]);
import resend
resend.api_key = "re_xxxxxxxxx"
params: resend.Contacts.Imports.ListParams = {
"limit": 10,
"status": "completed",
}
resend.Contacts.Imports.list(params)
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),
})
}
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(())
}
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 -X GET 'https://api.resend.com/contacts/imports?limit=10&status=completed' \
-H 'Authorization: Bearer re_xxxxxxxxx'
resend contacts imports list --limit 10 --status completed
{
"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
}
}
]
}