Skip to main content
GET
Get Data Freshness

Authorizations

Authorization
string
header
required

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

Query Parameters

fleet_ids
string<uuid>[] | null

Limit results to specific fleets. Maximum: 100 IDs. To specify multiple values, repeat the parameter for each value (e.g., ?fleet_ids=id1&fleet_ids=id2).

Maximum array length: 100
fleet_refs
string[] | null

Limit results to specific fleet references. Maximum: 100 references. To specify multiple values, repeat the parameter for each value (e.g., ?fleet_refs=ref1&fleet_refs=ref2).

Maximum array length: 100

Response

Successful Response

resource
enum<string>
required

The telematics resource type this entry describes.

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
fleet_id
string<uuid>
required

Unique identifier of the fleet this freshness record applies to.

connection_id
string<uuid>
required

Unique identifier of the telematics provider connection that supplies this resource's data.

schedule_id
string<uuid>
required

Unique identifier of the schedule that controls automatic data fetching for this resource.

source_name
string
required

Name of the telematics provider (e.g., geotab, samsara, motive).

tsp_id
string<uuid>
required

Unique identifier of the telematics service provider (TSP) at Catena.

tsp_slug
string
required

Human-readable identifier of the telematics service provider (TSP) at Catena.

last_successful_execution_at
string<date-time> | null
required

Timestamp of the most recent successful data fetch from the telematics provider for this resource. This is the primary data-freshness indicator. Null means no data has been fetched yet.

next_execution_at
string<date-time> | null
required

Timestamp of the next automatic data fetch.

schedule_status
enum<string> | null
required

Enum representing the possible statuses of a schedule.

Available options:
inactive,
active,
paused,
stale,
deleted,
cancelled,
cancelled_insufficient_scope
share_level
enum<string> | null

Enum for the level of access granted

Available options:
read,
read_write
fleet_ref
string | null

Partner's reference for the fleet in their system.

connection_description
string | null

Optional user-provided description of the connection. Useful when the fleet has multiple accounts with the same TSP.