Skip to main content
GET
/
catchAll
/
status
/
{job_id}
Get job status
curl --request GET \
  --url https://catchall.newscatcherapi.com/catchAll/status/{job_id} \
  --header 'x-api-key: <api-key>'
{
  "job_id": "af7a26d6-cf0b-458c-a6ed-4b6318c74da3",
  "status": "data_fetched"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication

Path Parameters

​
job_id
string<uuid>
required

Unique job identifier returned from the /catchAll/submit endpoint

Response

Status retrieved successfully

​
job_id
string<uuid>
required

Job identifier

Example:

"af7a26d6-cf0b-458c-a6ed-4b6318c74da3"

​
status
enum<string>
required

Current job processing status. Jobs progress through these stages:

  • pending: Job queued, waiting to start
  • analysis_started: Beginning query analysis
  • analysis_keywords_extracted: Keywords identified
  • analysis_enrichments_extracted: Validators and extractors generated
  • analysis_queries_extracted: Search queries created
  • retrieval_dispatched: Queries sent to fetching service
  • data_fetched: Articles retrieved
  • clustering_dispatched: Clustering initiated
  • data_grouped: Similar articles clustered
  • enrichment_dispatched: Validation and extraction started
  • data_enriched: Structured data extracted
  • job_completed: Job finished, results ready

Poll every 30-60 seconds until status is job_completed.

Available options:
pending,
analysis_started,
analysis_keywords_extracted,
analysis_enrichments_extracted,
analysis_queries_extracted,
retrieval_dispatched,
data_fetched,
clustering_dispatched,
data_grouped,
enrichment_dispatched,
data_enriched,
job_completed
Example:

"data_fetched"