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": "analyzing",
  "steps": [
    {
      "status": "submitted",
      "order": 1,
      "completed": true
    },
    {
      "status": "analyzing",
      "order": 2,
      "completed": false
    },
    {
      "status": "fetching",
      "order": 3,
      "completed": false
    },
    {
      "status": "clustering",
      "order": 4,
      "completed": false
    },
    {
      "status": "enriching",
      "order": 5,
      "completed": false
    },
    {
      "status": "completed",
      "order": 6,
      "completed": false
    },
    {
      "status": "failed",
      "order": 7,
      "completed": false
    }
  ]
}

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"

​
steps
object[]
required

Detailed progress tracking for each processing stage. Steps progress sequentially from order 1 (submitted) through 5 (enriching), ending at order 6 (completed) or 7 (failed).

​
status
string

Internal job processing status. Use the steps array for reliable status tracking.