List jobs

GET

/api/v1/jobs

curl -X GET 'https://dashboard.justcrawl.io/api/v1/jobs?status=completed&pageSize=10' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

• Production

Paginated list of scrape jobs in the current org. Filters compose: pass any combination of status, workflowId, scheduleId, domain, tag, plus the timestamp range filters (createdAfter/createdBefore/updatedAfter/updatedBefore). Heavy fields (executionTrace, nodeState) are stripped from list responses — fetch the single-job endpoint to get them. Each item carries cost derived from the org’s vendor-cost table.

Authorizations

• bearerAuth

Parameters

Query Parameters

page

integer

Page number (default 1)

pageSize

integer

Items per page (default 25, max 100)

status

string

Allowed values: pending running completed failed waiting_retry extracting extraction_done

Filter by job status

workflowId

string format: uuid

Filter by workflow ID

Responses

200

Paginated list of jobs

Media type application/json

object

items

Array<object>

object

id

string format: uuid

status

string

Allowed values: pending running completed failed waiting_retry extracting extraction_done

url

string

workflowId

string format: uuid

version

integer

providerId

string

nullable

statusCode

integer

nullable

latencyMs

integer

nullable

errorType

string

nullable

errorMessage

string

nullable

scheduleId

string format: uuid

nullable

createdAt

string format: date-time

completedAt

string format: date-time

nullable

total

integer

Examples

Example default

Paginated job list

{
  "items": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "status": "completed",
      "url": "https://www.walmart.com/ip/12345",
      "workflowId": "a47ac10b-58cc-4372-a567-0e02b2c3d479",
      "version": 3,
      "providerId": "brightdata",
      "statusCode": 200,
      "latencyMs": 1842,
      "cost": 0.00135,
      "createdAt": "2026-06-06T15:30:00.000Z",
      "completedAt": "2026-06-06T15:30:02.000Z"
    }
  ],
  "total": 1
}

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"
}