CatchAll Get Job Status — check job progress

CatchAll Get Job Status checks the processing status of a CatchAll job. It returns the current step, progress counts, and completion state. Use it to poll a job after submitting it with CatchAll Create Job.

This Actor maps to the GET /catchAll/status/{job_id} endpoint.

When to use this Actor

• Poll job progress. Check whether a job is still processing or has completed.
• Track step-by-step progress. See which processing stage the job is in: analyzing, fetching, clustering, validating, or extracting.
• Build conditional workflows. Trigger different actions based on job status using Apify integrations.

Input

Field	Type	Required	Description
apiKey	String	Yes	Your CatchAll API key
jobId	String	Yes	Job ID returned by CatchAll Create Job or the main CatchAll Actor

Input example

{
  "apiKey": "YOUR_CATCHALL_API_KEY",
  "jobId": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c"
}

Output

The Actor returns the job status, processing steps, and record counts in the default Dataset.

Output example

{
  "job_id": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
  "status": "completed",
  "limit": 10,
  "candidate_records": 15,
  "valid_records": 8,
  "progress_validated": 15,
  "steps": [
    { "name": "analyzing", "status": "completed", "completed": true },
    { "name": "fetching", "status": "completed", "completed": true },
    { "name": "clustering", "status": "completed", "completed": true },
    { "name": "validating", "status": "completed", "completed": true },
    { "name": "extracting", "status": "completed", "completed": true }
  ]
}

Key fields:

• candidate_records — total event clusters identified
• valid_records — records that passed validation
• progress_validated — how many candidates have been checked so far

When status is completed, use CatchAll Pull Results to retrieve the extracted records.

Tips

• Poll every 30–60 seconds. Jobs typically take 10–15 minutes to complete.
• Compare candidate_records and progress_validated to estimate remaining processing time.
• Check valid_records vs. limit to decide if you need to expand the job with CatchAll Continue.

Other CatchAll Actors

Actor	Description
CatchAll	End-to-end job: submit, poll, and retrieve results
CatchAll Create Job	Submit a job without polling
CatchAll Pull Results	Retrieve records from a completed job
CatchAll Early Results	Get partial results before completion

For the full list, visit the Newscatcher organization page.

Resources

• CatchAll documentation
• Jobs guide