Purpose: The purpose of this endpoint is to give an authenticated company a searchable, paginated list of published waste pickup events within a requested time window. t is the discovery endpoint: you use it to find which pickup events exist before drilling into any one event in detail.

🚧

IMPORTANT

This endpoint uses "OAuth 2.0 Client Credentials authentication through Motive CIAM". Check out the Overview - Authentication section for more info on generating the access token required to call this endpoint.

📘

NOTE

If you do not send has_overage, has_contamination, orinclude_all_pickups, it returns flagged events only.

Fields such as thumbnail_url, sd_url, front_facing_url, and rep_frame_url are presigned Amazon S3 GET URLs. They expire 3 hours after issuance (X-Amz-Expires=10800). Do not cache or persist them; request a fresh list or detail response when URLs expire.

Response Parameters

events

• Type: Array (Object)
• Description: A list of recorded event objects containing details about specific vehicle activities or occurrences.

offline_id

• Type: String (UUID)
• Description: The unique offline identifier assigned to the event.

type

• Type: String
• Description: The classification or category of the event (e.g., pickup).

start_time

• Type: String (Timestamp)
• Description: The date and time when the event began, in ISO 8601 format.

address

• Type: String
• Description: The physical location or street address where the event took place.

lat

• Type: Float
• Description: The geographical latitude coordinate of the event location.

lon

• Type: Float
• Description: The geographical longitude coordinate of the event location.

severity

• Type: String
• Description: The level of severity associated with the event (e.g., high).

has_overage

• Type: Boolean
• Description: Indicates whether the event involved an overage situation.

has_contamination

• Type: Boolean
• Description: Indicates whether contamination was detected during the event.

thumbnail_url

• Type: String (URL)
• Description: A pre-signed URL pointing to a thumbnail preview image of the event.

sd_url

• Type: String (URL)
• Description: A pre-signed URL pointing to the standard definition video recording of the event.

driver

• Type: Object
• Description: Details about the driver assigned to the event, if available.

vehicle

• Type: Object
• Description: Details regarding the vehicle associated with the event.

id

• Type: String
• Description: The unique identifier for the vehicle.

number

• Type: String
• Description: The fleet vehicle or unit number.

vin

• Type: String
• Description: The Vehicle Identification Number (VIN).

model_source

• Type: Array (String)
• Description: List of AI or system model sources triggered by the event.

overage

• Type: String
• Description: Model source tag indicating overage detection.

has_out_of_cab

• Type: Boolean
• Description: Indicates whether an out-of-cab incident or view was flagged during the event.

rep_frame_url

• Type: String (URL)
• Description: A pre-signed URL pointing to a representative frame image of the event.

page_no

• Type: Integer
• Description: The current page number of the paginated response.

per_page

• Type: Integer
• Description: The maximum number of events returned per page.

total

• Type: Integer
• Description: The total number of events matching the query across all pages.