List contact imports
GET/api/v1/contacts/imports
GET /contacts/imports
curl -X GET 'https://www.unitpost.com/api/v1/contacts/imports' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'User-Agent: my-app/1.0'Response · 200
{
"object": "list",
"has_more": false,
"data": [
{
"object": "contact_import",
"id": "id_123",
"status": "pending",
"total": 1,
"imported": 0,
"skipped": 0,
"failed": 0,
"invalid": [
{
"row": 0,
"reason": "string"
}
],
"error": "string",
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}
]
}Retrieve a list of your bulk contact-import jobs, newest-first and cursor-paginated. Each row is a reference to one import and its current progress. Start a new one with Start an async contact import, or drill into a single job with Retrieve a contact import. Requires the contacts:read capability.
Parameters3 fields
| Field | Type | Description |
|---|---|---|
limit | integer · query | Max rows to return (default 20, max 100). |
after | string · query | Return rows after this id (forward paging). |
before | string · query | Return rows before this id (backward paging). |
Response · 200 fields11 fields
| Field | Type | Description |
|---|---|---|
objectrequired | string | — |
idrequired | string | — |
statusrequired | enumpending | processing | completed | failed | — |
totalrequired | number | — |
importedrequired | number | — |
skippedrequired | number | — |
failedrequired | number | — |
invalidrequired | object[] | — |
errorrequired | object | — |
created_atrequired | string | — |
updated_atrequired | string | — |
200401422