curl -X GET 'https://api.resend.com/contacts/imports?status=queued&limit=10&after=example-after&before=example-before' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0'

# GET /contacts/imports (Resend API)
Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-03

> Retrieve a list of contact imports

## Critical Gotchas
* All requests must include a `User-Agent` header (e.g. `User-Agent: my-app/1.0`) or the API returns HTTP 403.
* The `to` field is an array of strings, even when sending to a single recipient.

## cURL
curl -X GET 'https://api.resend.com/contacts/imports?status=queued&limit=10&after=example-after&before=example-before' \
  -H "Authorization: Bearer $RESEND_API_KEY" \
  -H 'User-Agent: my-app/1.0'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| status | query | string | No | Filter contact imports by status. |
| limit | query | integer | No | Number of items to return. |
| after | query | string | No | Return items after this cursor. |
| before | query | string | No | Return items before this cursor. |

## Response (200 OK)
{"object":"list","has_more":false}

---
Need an API key? Get one at https://resend.com/signup

GET

/contacts/imports

Resend API

Retrieve a list of contact imports

Base URL: https://api.resend.com
Auth: Authorization: Bearer <RESEND_API_KEY>
Last verified: 2026-09-03 · upstream hash matched

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 223 tokens · Vary: Accept

Critical gotchas

All requests must include a User-Agent header (e.g. User-Agent: my-app/1.0) or the API returns HTTP 403.

The to field is an array of strings, even when sending to a single recipient.

cURL

curl -X GET 'https://api.resend.com/contacts/imports?status=queued&limit=10&after=example-after&before=example-before' \  -H "Authorization: Bearer $RESEND_API_KEY" \  -H 'User-Agent: my-app/1.0'

Get a free Resend API key → sponsored

Parameters

Name	In	Type	Required	Description
status	query	string	No	Filter contact imports by status.
limit	query	integer	No	Number of items to return.
after	query	string	No	Return items after this cursor.
before	query	string	No	Return items before this cursor.

Response 200 OK

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "contact_import",
      "id": "479e3145-dd38-476b-932c-529ceb705947",
      "status": "completed",
      "created_at": "2023-10-06 23:47:56.678+00",
      "completed_at": "2023-10-06 23:50:56.678+00",
      "counts": {
        "total": 100,
        "created": 80,
        "updated": 10,
        "skipped": 5,
        "failed": 5
      }
    }
  ]
}