Export status

Poll a leads CSV export job owned by the authenticated user and organization.

GET/api/leads/export-status/{task_id}

HTTP referenceScope authenticated user sessionUpdated April 25, 2026

This page documents the canonical HTTP contract for this endpoint.

The status lookup is scoped by authenticated organization and user; developer API keys are blocked. Runtime error/failed/timed_out values normalize to failed and partial/completed normalize to completed. The response includes progress, total, percentage, message, and result; terminal failure may add error. Use the result filename with the export download endpoint.

Path parameters

task_idrequired
string
Export task ID returned by the export endpoint.

Name	Type	Description
task_idrequired	string	Export task ID returned by the export endpoint.

Errors

Status	Meaning
401	Missing or invalid user session.
403	Developer API keys are blocked for this session-only route.
404	Export job not found.

Example

bash

curl -X GET "https://app.autotouch.ai/api/leads/export-status/abc123-def456" \
    -H "Authorization: Bearer <user_session_token>"

Response example

json

{
    "status": "processing",
    "progress": 25,
    "total": 100,
    "percentage": 25,
    "message": "Export in progress",
    "result": null
  }