Skip to main content
GET
Get Schedule

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

connection_id
string<uuid>
required
schedule_id
string<uuid>
required

Response

Successful Response

API Model for reading a schedule

id
string<uuid>
required

Unique identifier for the schedule.

connection_id
string<uuid>
required

The ID of the connection that this schedule belongs to.

resource
enum<string>
required

The type of resource being fetched on this schedule (e.g., VEHICLE, DRIVER, HOS, IFTA).

Available options:
asset,
document,
driver_association,
driver_vehicle_association,
driver_event_log,
driver_safety_event,
dvir_log,
dvir_log_defect,
engine_log,
engine_status,
fuel_transaction,
fuel_card,
fleet_info,
hos_availability,
hos_daily_log,
hos_daily_snapshot,
hos_event,
hos_event_annotation,
hos_event_attachment,
hos_violation,
ifta_summary,
location_segment,
message,
group_message,
user,
vehicle,
vehicle_location,
vehicle_sensor,
vehicle_region_segment,
trailer,
trailer_association,
trailer_vehicle_association,
trailer_location,
trailer_status,
workflow
execution_interval_seconds
integer
required

The interval between scheduled executions in seconds.

status
enum<string>
required

The current status of the schedule (ACTIVE, INACTIVE).

Available options:
inactive,
active,
paused,
stale,
deleted,
cancelled,
cancelled_insufficient_scope
consecutive_error_count
integer
required

The number of consecutive errors that have occurred for this schedule.

consecutive_error_threshold
integer
required

The number of consecutive errors allowed before the schedule is automatically set to INACTIVE.

max_concurrent_executions
integer
required

The maximum number of concurrent executions allowed for this schedule.

cursor
string | null

Resource-specific state used to resume incremental fetching.

last_data_at
string<date-time> | null

Timestamp of the most recent data point received from the TSP.

fetch_window_end_at
string<date-time> | null

End timestamp of the last fetch window. Used by chunked adapters to advance backfills across executions.