Skip to main content
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',
});

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "contact_import",
      "id": "479e3145-dd38-476b-932c-529ceb705947",
      "status": "completed",
      "created_at": "2026-05-15T18:32:37.823Z",
      "completed_at": "2026-05-15T18:33:42.916Z",
      "counts": {
        "total": 1200,
        "created": 800,
        "updated": 300,
        "skipped": 75,
        "failed": 25
      }
    }
  ]
}
Contact Imports are currently in beta and only available to a limited number of users. APIs might change before GA.Contact us if you’re interested in testing this feature.

​
Query Parameters

​
limit
number
Number of contact imports to retrieve.
  • Default value: 10
  • Maximum value: 100
  • Minimum value: 1
​
after
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.
​
before
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.
​
status
'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',
});

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