API referenceContacts
Get a contact import job's status
GET
bearerAuthheader
AuthorizationBearer <token>API key sent as Authorization: Bearer <key>. Looked up by SHA-256
hash (email_core::sha256_hex) against api_keys.hash; revoked
keys and keys belonging to a suspended tenant are rejected. See the
top-level Authentication section for permission levels.
id*stringThe import_id/export_id returned when the job was created.
Import job status.
application/json- response
id?stringstatus?stringValue in
"pending""processing""done""failed"total?integerData rows seen so far (0 until the first tick reads the header).
imported?integerfailed?integererror_sample?array<>Up to 100 row-level failures. Never the raw CSV line (may carry PII) — only the row number and a stable error code.
created_at?integerFormat
int64updated_at?integerFormat
int64curl -X GET "https://example.com/v1/contacts/imports/string"{ "id": "string", "status": "pending", "total": 0, "imported": 0, "failed": 0, "error_sample": [ { "row": 0, "error": "string" } ], "created_at": 0, "updated_at": 0}