Discussions

Ask a Question
Back to all

What is the reason I don't get downloaded videos in driver_performence_events/v2 API

Missing downloadable_videos in driver_performance_events/v2 API response

Problem

When calling the Motive API endpoint /v2/driver_performance_events, the response includes camera_media objects, but the downloadable_videos field is often missing or empty, even when camera_media.available is true and cam_positions indicates cameras are present.

Expected Behavior

Based on the API documentation, when camera media is available, I expect to see:
{
"camera_media": {
"id": 12345,
"available": true,
"cam_positions": ["front_facing", "driver_facing"],
"downloadable_videos": {
"driver_facing_plain_url": "https://...",
"front_facing_plain_url": "https://...",
"dual_facing_enhanced_url": "https://..."
}
}
}

Actual Behavior

I'm receiving responses like:
{
"camera_media": {
"id": 12345,
"available": true,
"cam_positions": ["front_facing", "driver_facing"]
// downloadable_videos is missing or null
}
}

Questions

  1. Is there a separate API call required to fetch video URLs after getting the performance events?
  2. Are there specific query parameters needed to include downloadable_videos in the response?
  3. Is there a delay between event creation and video availability?
  4. Are there permission/scope requirements for accessing video URLs?
  5. Is there a different endpoint or workflow for retrieving video URLs for performance events?

Context

  • API Version: v2
  • Endpoint: /v2/driver_performance_events
  • Use Case: Fetching performance events (hard_brake, hard_acceleration, etc.) with associated video footage
  • Authentication: Using API key authentication

Additional Information

  • Events are being returned successfully
  • camera_media.available is often true
  • cam_positions shows which cameras are present

Any guidance on how to access the video URLs would be greatly appreciated!