Skip to main content
Documentation

API Reference

List bulk jobs

HTTP ReferenceCLI Available
GET/api/bulk-jobs

Required scope: jobs:read

List native executor jobs for domains that own bulk jobs and inspect executor references when a Research Table operation run links one.

Updated March 1, 2026

This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.

Query parameters

  • table_idOptional

    string

    Filter by table ID.

  • column_idOptional

    string

    Filter by column ID.

  • statusOptional

    string

    Single status or comma-separated statuses.

  • providerOptional

    string

    Filter by provider.

  • limitOptional

    number

    1-100. Default 20.

Example

bash
curl -X GET "https://app.autotouch.ai/api/bulk-jobs?table_id=67bd8c39c7d3e80f0a95b560&column_id=67bd8cd8c7d3e80f0a95b58f&limit=1" \
    -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json
{
    "jobs": [
      {
        "job_id": "bulk_20260301_8f13a2d1",
        "table_id": "67bd8c39c7d3e80f0a95b560",
        "column_id": "67bd8cd8c7d3e80f0a95b58f",
        "provider": "email_finder",
        "status": "processing",
        "total_rows": 200,
        "dispatched_rows": 200,
        "processed_rows": 87,
        "error_rows": 2,
        "skipped_rows": 15,
        "pending_batches": 3,
        "terminal_reason": null,
        "errors": [],
        "created_at": "2026-03-01T19:02:12.134Z",
        "updated_at": "2026-03-01T19:03:08.422Z"
      }
    ],
    "count": 1,
    "limit": 1,
    "filters": {
      "table_id": "67bd8c39c7d3e80f0a95b560",
      "column_id": "67bd8cd8c7d3e80f0a95b58f",
      "status": null,
      "provider": null
    }
  }

Errors

  • 401

    Invalid API key or missing auth.

  • 403

    Missing jobs:read scope.

Docs