List Rotation Schedules

GET/api/v1/admin/proxy/schedules

note

This endpoint requires Admin API Key authentication via the X-Admin-Key header.

Returns all scheduled rotations, optionally filtered by location or modem.

Query Parameters

location_idstring

Filter schedules by location UUID

modem_idstring

Filter schedules by modem UUID

is_enabledboolean

Filter by enabled/disabled status

Response

Returns an array of schedule objects:

schedule_idstring

UUID of the schedule

location_idstring

Location UUID (if location-wide schedule)

modem_idstring

Modem UUID (if modem-specific schedule)

interval_minutesinteger

Rotation interval in minutes

rotation_methodstring

Method: reconnect, airplane, or reboot

is_enabledboolean

Whether schedule is active

next_run_atstring

ISO timestamp of next scheduled rotation

last_run_atstring

ISO timestamp of last rotation

Request Example

curl -X GET "https://spideriq.ai/api/v1/admin/proxy/schedules" \
  -H "X-Admin-Key: your_admin_key"

import requests

response = requests.get(
    "https://spideriq.ai/api/v1/admin/proxy/schedules",
    headers={"X-Admin-Key": "your_admin_key"}
)
print(response.json())

Response Example

[
  {
    "schedule_id": "a1b2c3d4-...",
    "location_id": "8746d96a-...",
    "modem_id": null,
    "interval_minutes": 60,
    "rotation_method": "reconnect",
    "is_enabled": true,
    "next_run_at": "2026-01-05T14:00:00Z",
    "last_run_at": "2026-01-05T13:00:00Z"
  }
]