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": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
  "status": "completed",
  "steps": [
    {
      "status": "submitted",
      "order": 1,
      "completed": true
    },
    {
      "status": "analyzing",
      "order": 2,
      "completed": true
    },
    {
      "status": "fetching",
      "order": 3,
      "completed": true
    },
    {
      "status": "clustering",
      "order": 4,
      "completed": true
    },
    {
      "status": "enriching",
      "order": 5,
      "completed": true
    },
    {
      "status": "completed",
      "order": 6,
      "completed": true
    },
    {
      "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 POST /catchAll/submit.

Response

Status retrieved successfully

​
job_id
string<uuid>
required

Job identifier.

Example:

"5f0c9087-85cb-4917-b3c7-e5a5eff73a0c"

​
status
enum<string>

Current job processing status.

Available options:
submitted,
analyzing,
fetching,
clustering,
enriching,
completed,
failed
Example:

"fetching"

​
steps
object[]

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).