List schedules

GET

/api/v1/schedules

curl -X GET 'https://dashboard.justcrawl.io/api/v1/schedules?page=1&pageSize=25&isEnabled=true' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

import os, requests
r = requests.get(
    'https://dashboard.justcrawl.io/api/v1/schedules',
    headers={'Authorization': f'Bearer {os.environ["JUSTCRAWL_API_KEY"]}'},
    params={'page': 1, 'pageSize': 25, 'isEnabled': 'true'},
)
r.raise_for_status()
page = r.json()

const params = new URLSearchParams({ page: '1', pageSize: '25', isEnabled: 'true' });
const res = await fetch(`https://dashboard.justcrawl.io/api/v1/schedules?${params}`, {
  headers: { Authorization: `Bearer ${process.env.JUSTCRAWL_API_KEY}` },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const page = await res.json();

Returns a paginated slice of the org’s schedules, each enriched server-side with workflowName (resolved from the bound workflow or "Automatic" when no workflowId is set), urlCount (matching URLs at request time), and estCost (domain-aware per-thousand-URL cost projection in cents). The cost projection uses the schedule’s bound workflow DAG plus the org’s per-provider pricing table — so it reflects what the next run will actually charge under current credentials. This endpoint backs the MCP server’s jc_schedules_list tool.

Authorizations

bearerAuth

Parameters

Query Parameters

page

integer

default: 1 >= 1

pageSize

integer

default: 25 <= 100

frequency

string

Filter to schedules with this cadence (e.g. hourly, daily).

isEnabled

boolean

Filter by active state.

domain

string

Filter to schedules whose tag filters resolve URLs on this domain.

tag

string

Filter to schedules carrying this tag in tagFilters.

Responses

200

Paginated list of schedules, enriched with workflow name, URL count, and cost projection.

application/json

object

items

Array<object>

object

string format: uuid

name

string

workflowId

string format: uuid

nullable

tagFilters

Array<string>

frequency

string

Allowed values: hourly daily weekly monthly custom

cronExpr

string

timezone

string

isEnabled

boolean

nextRunAt

string format: date-time

lastRunAt

string format: date-time

nullable

createdAt

string format: date-time

total

integer

Example

{
  "items": [
    {
      "frequency": "hourly"
    }
  ]
}

400

Validation failed — request body or query is missing/invalid

application/json

object

error

string

Example

{
  "error": "Missing or invalid \"url\" field"
}

401

Missing or invalid authentication token

application/json

object

error

string

Example

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

403

Insufficient permissions for this operation

application/json

object

error

string

Example

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

500

Unexpected server error. Logs and PostHog $exception capture

application/json

object

error

string

Example

{
  "error": "Something went wrong"
}