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/v3"
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
}
}
]
}
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/v3"
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
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.
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/v3"
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