Fetch a single waste pickup event

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Purpose: The purpose of this endpoint is to return the full detail for one specific published waste pickup event identified by its offline_id from the list endpoint. This endpoint is meant for detailed review screens, investigations, or evidence panels where a user needs to understand what happened in this one pickup event, see the associated media, and correlate it with the vehicle’s movement nearby.

🚧

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.

Response Parameters

pickup

  • Type: Object
  • Description: Container object containing detailed information about the pickup event.

offline_id

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

type

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

tags

  • Type: Array (String)
  • Description: List of classification tags associated with the pickup event.

overage

  • Type: String
  • Description: Tag indicating an overage condition during pickup.

start_time

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

end_time

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

address

  • Type: String
  • Description: The physical street address location of the pickup event.

lat

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

lon

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

severity

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

thumbnail_url

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

front_facing_url

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

driver

  • Type: Object
  • Description: Details about the driver assigned to the pickup 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 system or AI model sources triggered by the pickup event.

has_out_of_cab

  • Type: Boolean
  • Description: Indicates whether an out-of-cab event or view was recorded.

rep_frame_url

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

vehicle_locations

  • Type: Array (Object)
  • Description: A list of location data points recorded for the vehicle during the pickup event.

vehicle_location

  • Type: Object
  • Description: Container object representing a specific vehicle location data point.

bearing

  • Type: Integer
  • Description: The direction of travel in degrees relative to true north.

located_at

  • Type: String (Timestamp)
  • Description: The timestamp when the specific location data point was recorded.

description

  • Type: String
  • Description: Optional text description of the vehicle location.

motion_description

  • Type: String
  • Description: A human-readable description of the vehicle's direction and speed at the location point.

Path Params
string
required

Unique identifier of the pickup event. This can be fetched using the "Fetch all waste pickup events" endpoint.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json