Batch poll job statuses

POST

/api/v1/jobs/batch-status

curl --request POST \
  --url https://api.justcrawl.io/api/v1/jobs/batch-status \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "jobIds": [ "example" ] }'

• Production

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

object

jobIds

required

Array<string>

Example^generated

{
  "jobIds": [
    "example"
  ]
}

Responses

200

Array of compact job-status records — one per requested jobIds entry that exists in this org (missing IDs are silently omitted, never error). Returned as a bare array, not wrapped under a key.

Media typeapplication/json

Array<object>

object

id

required

string format: uuid

status

required

Current job status (e.g. pending, processing, completed, failed).

string

currentNodeId

Workflow node currently executing, or null when terminal.

string

nullable

purpose

required

Distinguishes customer crawl jobs from auxiliary preview capture jobs.

string

Allowed values: crawl preview_capture

parentJobId

required

Parent crawl for a preview capture; null for ordinary crawls.

string format: uuid

nullable

updatedAt

required

string format: date-time

Example

[
  {
    "purpose": "crawl"
  }
]

400

Missing/empty jobIds array, or more than 100 IDs per request.

401

Missing or invalid authentication token

Media typeapplication/json

object

error

string

Example

{
  "error": "Missing or invalid authentication token"
}

403

Insufficient permissions for this operation

Media typeapplication/json

object

error

string

Example

{
  "error": "No organization. Complete onboarding first."
}

500

Unexpected server error. Logs and PostHog $exception capture

Media typeapplication/json

object

error

string

Example

{
  "error": "Something went wrong"
}