Skip to main content
Autotouch AI
Book a demo
Autotouch AI
Sign inBook a demo
Documentation

API Reference

Get bulk job status

HTTP ReferenceCLI Available
GET/api/bulk-jobs/{job_id}

Required scope: jobs:read

Inspect a native bulk-job executor receipt. Research Table column progress is owned by operation runs.

Updated March 1, 2026

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

Path parameters

  • job_idRequired

    string

    Native executor job ID returned alongside operationRunId when this run uses a bulk executor.

Example

bash
curl -X GET "https://app.autotouch.ai/api/bulk-jobs/bulk_20260225_5fd85a73" \
    -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json
{
    "job_id": "bulk_20260225_5fd85a73",
    "table_id": "67bd8c39c7d3e80f0a95b560",
    "column_id": "67bd8cd8c7d3e80f0a95b58f",
    "provider": "llm_enrichment",
    "status": "processing",
    "total_rows": 250,
    "dispatched_rows": 250,
    "processed_rows": 147,
    "error_rows": 3,
    "skipped_rows": 11,
    "pending_batches": 2,
    "terminal_reason": null,
    "errors": [],
    "billable": true,
    "billing_model": "per_row",
    "billing_notes": "Server-managed LLM pricing. Range reflects runtime policy (lite/standard).",
    "billable_rows_estimated": 250,
    "billable_rows_processed": 147,
    "credits_estimated_min": 50.0,
    "credits_estimated_max": 250.0,
    "credits_used": 132.4,
    "credit_events_count": 147,
    "billing_updated_at": "2026-02-25T18:33:08.422Z",
    "created_at": "2026-02-25T18:32:12.134Z",
    "updated_at": "2026-02-25T18:33:08.422Z",
    "enqueued_at": "2026-02-25T18:32:12.455Z",
    "orchestrator_task_id": "8d6af7f6-e75b-4e11-8f5a-46af4e6549f2",
    "run_scope": {
      "sequence_id": null,
      "research_context": null
    }
  }

Errors

  • 401

    Invalid API key or missing auth.

  • 403

    Missing jobs:read scope.

  • 404

    Bulk job not found.

Docs