Batch poll job statuses

POST

/api/v1/jobs/batch-status

curl --request POST \
  --url https://dashboard.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 type application/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 type application/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

updatedAt

required

string format: date-time

Example ^generated

[
  {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "status": "example",
    "currentNodeId": "example",
    "updatedAt": "2026-04-15T12:00:00Z"
  }
]

400

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

401

Missing or invalid authentication token

Media type application/json

object

error

string

Example

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

403

Insufficient permissions for this operation

Media type application/json

object

error

string

Example

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

500

Unexpected server error. Logs and PostHog $exception capture

Media type application/json

object

error

string

Example

{
  "error": "Something went wrong"
}