Get lead import status

Read the status and result of a lead CSV import task.

GET/api/leads/import/status/{task_id}

HTTP referenceScope leads:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

The task status is organization-scoped. A small CSV can be processed inline; otherwise the response is an admission receipt. The status response has the documented progress fields and can include a nested result after processing. The response is the import status/result JSON returned by the import command.

Path parameters

task_idrequired
string

Name	Type	Description
task_idrequired	string	-

Errors

Status	Meaning
401	Missing or invalid authentication.
403	Missing leads:write scope.
404	Import task not found.

Example

bash

curl "https://app.autotouch.ai/api/leads/import/status/0123456789abcdef0123456789abcdef" -H "Authorization: Bearer $AUTOTOUCH_API_KEY"

Response example

json

{"status":"processing","task_id":"0123456789abcdef0123456789abcdef","job_id":"0123456789abcdef0123456789abcdef","provider":"lead_import","message":"Lead import queued","stage":"queued","progress":0,"processed_rows":0,"total":1,"total_rows":1,"progress_percent":0}