> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FleetCam

> Connect FleetCam dashcam and telematics data to your agents

## Connect FleetCam

FleetCam is FTS GPS's dashcam and telematics product, also sold through SmartAsset. An Aster organization admin can connect one FleetCam account in **Control Hub > Integrations > FleetCam**. The connection is shared across the organization.

1. In FleetCam Engage, open **Integrations > FleetCam REST API** and generate a client ID and secret. The secret is shown once.
2. Make sure the API client can read the data agents need. Vehicles, events and odometer work on a basic client; GPS logs, idle logs and vehicle status need telematics access, which your FleetCam admin grants.
3. Paste the client ID and secret into Aster and save. Aster signs in and reads one vehicle before saving.
4. Enable `fleetcam_query` on your agent.

## Available tool

`fleetcam_query` reads one endpoint per call. List endpoints are paged inside the call up to `max_rows` (default 1,000), and large results are attached as a file.

| Endpoint | Returns |
| - | - |
| `vehicles`, `vehicles/{vehicleId}` | Vehicle directory: name, VIN, plate, make/model, DVR and cameras, groups |
| `vehicles/status` (POST `{allVehicles: 1}`) | Current status and last location |
| `vehicles/log/{vehicleId}`, `vehicles/idle/{vehicleId}` | GPS and idle logs over a date range |
| `vehicles/dailyOdometer`, `vehicles/dailyStateMiles` | Daily odometer readings and miles by state (`distanceType` 0 = miles) |
| `events` (POST), `events/type`, `events/logs/{eventId}`, `events/{eventId}/urls` | Safety events, event GPS logs, and which cameras saved video |
| `vehicles/connectivity` (POST), `vehicles/{vehicleId}/connectivity` | Camera heartbeat, power and signal |
| `timeframes` (POST) | When recorded footage is available |
| `groups`, `companies` | Group hierarchy and companies |

Dates must be ISO-8601 with an offset, such as `2026-11-16T00:00:00-05:00`; bare dates are rejected.

## Example prompts

* "How many miles did each truck drive by state last week?"
* "List this month's safety events for Truck 23."
* "Which cameras haven't checked in today?"

## Coverage and troubleshooting

This version is read-only. It does not start live or historical video streams, download event video, or change vehicles and groups.

* **403 "denied access to this endpoint":** the API client lacks that permission. Ask your FleetCam admin to grant it.
* **400:** the message names the bad parameter, usually a date without an offset.

FleetCam meters token issuance, so Aster stores the 6-hour token and reuses it. The client secret and token stay server-side and are redacted in connection responses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.