# Vision API

The Vision API is implemented by camera and vision integration partners. Hauler Hero calls the partner's endpoints to request, list, and download truck-camera video — both on-demand clips and continuous route recordings. See the [Vision API Integration Guide](/vision-integration) for workflows and endpoint details.


Version: 1.11.0

## Servers

**Placeholder.** `api.yourcompany.com` is not a real URL — when you implement this API, substitute your own public server URL.

```
https://api.yourcompany.com
```

## Security

### apiKey

API key for authenticating requests.

To obtain an API key:
- Contact your account manager
- Email: integrations@haulerhero.com

Include in request header: `API-KEY: your_api_key_here`


Type: apiKey
In: header
Name: API-KEY

## Download OpenAPI description

[Vision API](https://docs.haulerhero.com/_bundle/vision.yaml)

## On-Demand Video

Request and retrieve on-demand video clips for specific stops or work orders

### Request on-demand video

 - [POST /video-hero/v1/videos/requests](https://docs.haulerhero.com/vision/on-demand-video/requestvideo.md): Initiates the process of video discovery and preparation for export.
Specify the video source (customer, truck, camera) and a time range
(start and end timestamps in ISO 8601 format) for the video to be requested.

### List available videos

 - [GET /video-hero/v1/videos](https://docs.haulerhero.com/vision/on-demand-video/listvideos.md): Returns a paginated list of available videos based on filtering specifications.
Use this endpoint to poll whether requested videos have been prepared and are
available for downloading. Each element specifies the video source, time range,
and provides a downloadable link (which may be valid temporarily).

## Continuous Video

Access continuous full-route video recordings

### List continuous recordings

 - [GET /video-hero/v1/videos/continuous](https://docs.haulerhero.com/vision/continuous-video/listcontinuousrecordings.md): Returns a paginated list of all continuous recordings available within a given
source and time range. Recordings are chunked into constant time durations.
This endpoint enables customers to access a continuous video showing the truck
moving along the full length of its route.