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"