Get Job | Captain

import json
import requests
BASE_URL = "https://acme.captain.dev"
API_KEY = "your_write_key"
JOB_ID = "job_20260928213040_9b27e1"
headers = {
    "Authorization": f"Bearer {API_KEY}",
}
response = requests.get(
    f"{BASE_URL}/v1/jobs/{JOB_ID}",
    headers=headers,
    timeout=30.0,
)
print(json.dumps(response.json(), indent=2))

{
  "id": "job_20260928213040_9b27e1",
  "type": "index.import",
  "index": "products",
  "status": "succeeded",
  "created_at": 1759095040,
  "started_at": 1759095040,
  "finished_at": 1759095161,
  "stages": [
    {
      "name": "pull",
      "status": "done",
      "records": 12840,
      "synonyms": 46,
      "rules": 6,
      "notes": []
    },
    {
      "name": "map",
      "status": "done"
    }
  ],
  "error": null,
  "result": {
    "records": 12840,
    "report": "/v1/indexes/products/import/report",
    "build_job": "job_20260928213301_4c8d2e",
    "documents": 12840,
    "counts": {
      "records": 12840,
      "synonyms": 46,
      "rules": 6
    }
  }
}

Get a job’s status and stages, and a build’s progress. A write key reads the jobs it started and the automatic builds of its indexes, the ones Get Update Status names. Any other job answers 404 JOB_NOT_FOUND.

Authentication

AuthorizationBearer

A write key, issued by Captain. Server side only. Sent as Authorization: Bearer <key>.

Path parameters

job_idstringRequired

Response

job

idstringOptional

typeenumOptional

index.write: record updates and deletes through the ordered update log, one job per burst

Allowed values:

indexstringOptional

seq_fromintegerOptional

index.write: the first update this job carries

seq_tointegerOptional

index.write: the last update this job carries

recordsintegerOptional

index.write: records written

statusenumOptional

landed_for_review: a write key's Algolia import, stored for a Captain engineer to review

created_atintegerOptional

started_atinteger or nullOptional

finished_atinteger or nullOptional

stageslist of objectsOptional

progressobjectOptional

index.build: how far the build has got. records_done counts the records the running step has done; a step that doesn't count records (tables, verify, publish) reports every record done

build_idstringOptional

errorstring or nullOptional

error_codestringOptional

set when a build failed over the customer's data, not a server fault: BAD_VALUES (more than half of a field's values don't fit its declared type; see bad_values)

bad_valueslist of objectsOptional

with error_code BAD_VALUES: per field, count of bad values, of how many, and up to 3 examples

warningslist of objectsOptional

Object Search builds: settings resolved by a rule (the same warnings GET settings shows)

facet_reportlist of objectsOptional

Object Search builds: per number or date facet, whether it has value counts and why

resultobject or nullOptional