Get Job | Captain Docs

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": "landed_for_review",
  "created_at": 1759095040,
  "started_at": 1759095040,
  "finished_at": 1759095161,
  "stages": [
    {
      "name": "pull",
      "status": "done",
      "items": 12840,
      "of": 12840,
      "seconds": 118
    }
  ],
  "error": null,
  "result": {
    "counts": {
      "records": 12840,
      "synonyms": 46,
      "rules": 6
    },
    "next": "a Captain engineer reviews the export, then the records load into the index"
  }
}

Get an import job's status and stages. A write key reads only the jobs it started.

Authentication

AuthorizationBearer

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

Path parameters

job_idstringRequired

Response

job

idstringOptional

typeenumOptional

Allowed values:

indexstringOptional

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

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