Get blacklist statistics job

Read the queued blacklist job status, progress, and eventual statistics.

GET/api/tables/{table_id}/blacklist/{column_key}/stats/{job_id}

HTTP referenceScope tables:readUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

The status envelope includes optional progress counts, optional final stats, and optional error. The job runner owns status values; poll until a terminal result. A missing job or inaccessible table is reported as an HTTP error.

Path parameters

table_idrequired
string
Research Table ID.
column_keyrequired
string
URL/domain column key.
job_idrequired
string
ID returned by the start route.

Name	Type	Description
table_idrequired	string	Research Table ID.
column_keyrequired	string	URL/domain column key.
job_idrequired	string	ID returned by the start route.

Errors

Status	Meaning
401	Authentication is required.
403	The caller lacks access to the resource or the tables:read scope.
400	The request does not satisfy the route or typed request contract.

Example

bash

curl -X GET "https://app.autotouch.ai/api/tables/68d2c6a1a833d60619000001/blacklist/company_domain/stats/68d2c6a1a833d6061900000200000002" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY"

Response example

json

{
  "job_id": "68d2c6a1a833d6061900000200000002",
  "status": "completed",
  "processed_rows": 2400,
  "total_rows": 2400,
  "stats": {"totalCount": 2400, "rowsWithDomain": 2200, "uniqueDomainsChecked": 1800, "blacklistedCount": 4, "matchedDomains": [], "blacklistedDomains": [], "sampleRows": []},
  "error": null
}