Get company import status

Check a company CSV import by its returned task ID.

GET/api/companies/import-status/{task_id}

HTTP referenceScope companies:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

Poll this route after asynchronous import admission. Lookup is scoped to the authenticated organization and user, and it also requires user-admin permission plus companies:write; the same administrator gate applies to the upload endpoint.

Path parameters

task_idrequired
string
Task ID returned when the import was accepted.

Name	Type	Description
task_idrequired	string	Task ID returned when the import was accepted.

Errors

Status	Meaning
401	Authentication and organization/user context required.
403	Missing companies:write scope or user-admin permission.
404	Import task not found for this organization/user.
503	Runtime scope configuration is unavailable.

Example

bash

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

Response example

json

{"status":"processing","task_id":"job_123","job_id":"job_123","provider":"company_account_import","message":"Import is processing","stage":"importing","progress":10,"processed_rows":10,"total":25,"total_rows":25,"progress_percent":40}