Retrieve a contact import
GET/api/v1/contacts/imports/{id}
GET /contacts/imports/{id}
curl -X GET 'https://www.unitpost.com/api/v1/contacts/imports/imp_123' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'User-Agent: my-app/1.0'Response · 200
{
"object": "contact_import",
"id": "id_123",
"status": "pending",
"total": 1,
"imported": 0,
"updated": 0,
"skipped": 0,
"failed": 0,
"invalid": [
{
"row": 0,
"reason": "string"
}
],
"error": "string",
"update_existing": false,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z"
}Retrieve a bulk import job by id to check its status and per-row results — how many contacts were created, updated, or skipped, and why any rows failed. Poll this while an import runs. Start one with Start an async contact import. Requires the contacts:read capability.
Parameters1 field
| Field | Type | Description |
|---|---|---|
idrequired | string · path | — |
Response · 200 fields13 fields
| Field | Type | Description |
|---|---|---|
objectrequired | string | — |
idrequired | string | — |
statusrequired | enumpending | processing | completed | failed | canceled | — |
totalrequired | number | — |
importedrequired | number | — |
updatedrequired | number | — |
skippedrequired | number | — |
failedrequired | number | — |
invalidrequired | object[] | — |
errorrequired | string | null | — |
update_existingrequired | boolean | — |
created_atrequired | string | — |
updated_atrequired | string | — |
200401404