With this release, we are introducing 2 new endpoints that fetch AI-generated waste pickup events for the authenticated company. These APIs allow integrations to search published pickup events and retrieve detailed information for an individual pickup.

The Waste Pickup APIs now use OAuth 2.0 Client Credentials authentication through Motive CIAM. For authentication details, see the Waste Pickup APIs Overview.

Endpoints

Fetch all the Waste Pickup Events

• URL: https://api.gomotive.com/api/aivision/v1/pickups
• Method: GET
• Purpose: Use this API to fetch a searchable, paginated list of published waste pickup events for the authenticated company. You can filter events by criteria such as time range, pickup type, loader type, confidence, and pagination parameters.

Read the API documentation

Fetch a single Waste Pickup Event

• URL: https://api.gomotive.com/api/aivision/v1/pickups/{id}
• Method: GET
• Purpose: Use this API to fetch the complete details of a specific published waste pickup event. The response includes event timing, vehicle information, location, detection results, confidence, and available media coverage.

Read the API documentation

Authentication

The Waste Pickup APIs use OAuth 2.0 Client Credentials authentication through Motive CIAM. Obtain an access token from the CIAM token endpoint and include it in the Authorization header of every API request.

• Token URL: https://ciam.gomotive.com/oauth/token
• Header: Authorization: Bearer <ACCESS_TOKEN>
• Grant type: client_credentials

For the complete authentication flow, request parameters, and response structure, see the Waste Pickup APIs Overview.