Get list build status

Inspect durable list-build progress, total results, credits used, and terminal status.

GET/api/list-builds/{job_id}

HTTP referenceScope search:runUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

Status values include queued, running, completed, error, cancelled, budget_exhausted, and manual_review. The last two are terminal states; inspect the completion and budget details rather than treating them as successful completion.

Path parameters

job_idrequired
string
List-build job ID returned by create.

Name	Type	Description
job_idrequired	string	List-build job ID returned by create.

Errors

Status	Meaning
401	Invalid API key or missing auth.
403	Missing search:run scope.
404	List build job not found.

Example

bash

curl -X GET "https://app.autotouch.ai/api/list-builds/lb_1234567890abcdef12345678" \
  -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json

{
  "job_id": "lb_1234567890abcdef12345678",
  "kind": "companies",
  "status": "running",
  "progress": 40,
  "total_results": 400,
  "credits_used": 4,
  "pricing_rule": "1 credit per successful result page"
}