---
title: "Fetch authorised Wex route, trip, fuel and diagnostic data"
method: GET
path: "/api/v1/operations/tracking/{vehicleId}/route"
tags: ["Tracking"]
---

# Fetch authorised Wex route, trip, fuel and diagnostic data

`GET /api/v1/operations/tracking/{vehicleId}/route`

## Request

- Base URL: `https://fleetkeep.co.uk`
- URL: `https://fleetkeep.co.uk/api/v1/operations/tracking/{vehicleId}/route`
- Auth: OAuth 2 (authorization code, authorization URL `https://fleetkeep.co.uk/auth/oauth2/authorize`, token URL `https://fleetkeep.co.uk/auth/oauth2/token`, scopes: `operations:read`)

Calls Wex only after tenant ownership and an active Wex link are proven. A successful response proves only that this request returned provider data; it does not claim general account feed availability.

## Path parameters

- `vehicleId` string, uuid, required

## Query parameters

- `period` 'today' | 'yesterday' | '7d'

## Response `200`

Bounded provider response

- TrackingRoute
  - `points` TrackingRoutePoint[], required
    - `recordedAt` string, date-time, required
    - `latitude` number, required
    - `longitude` number, required
    - `speedMph` number, nullable, required
    - `headingDegrees` number, nullable, required
    - `ignition` boolean, nullable, required
    - `odometerMiles` number, nullable, required
  - `trips` TrackingTrip[], required
    - `type` 'trip' | 'idle' | 'stop', required
    - `startedAt` string, date-time, required
    - `endedAt` string, date-time, nullable, required
    - `distanceMiles` number, nullable, required
    - `durationMinutes` number, nullable, required
    - `maxSpeedMph` number, nullable, required
    - `startLatitude` number, nullable, required
    - `startLongitude` number, nullable, required
    - `endLatitude` number, nullable, required
    - `endLongitude` number, nullable, required
  - `fuelTransactions` TrackingFuelTransaction[], nullable, required
    - `occurredAt` string, date-time, required
    - `transactionId` string, nullable, required
    - `volumeGallons` number, nullable, required
    - `amount` number, nullable, required
    - `pricePerGallon` number, nullable, required
    - `product` string, nullable, required
    - `siteName` string, nullable, required
    - `brandName` string, nullable, required
    - `stationAddress` string, nullable, required
    - `stationLatitude` number, nullable, required
    - `stationLongitude` number, nullable, required
    - `vehicleLatitude` number, nullable, required
    - `vehicleLongitude` number, nullable, required
    - `odometerMiles` number, nullable, required
    - `gpsDistanceMiles` number, nullable, required
    - `driverName` string, nullable, required
    - `cardName` string, nullable, required
    - `fuelLevelBefore` number, nullable, required
    - `fuelLevelAfter` number, nullable, required
    - `estimatedUkMpg` number, nullable, required
  - `diagnosticCodes` string[], nullable, required
  - `provider` 'wex', required
  - `period` 'today' | 'yesterday' | '7d', required
  - `truncated` object, required
    - `points` boolean, required
    - `trips` boolean, required
    - `fuelTransactions` boolean, required
    - `diagnosticCodes` boolean, required

## Other responses

- `400`: The request body or query was invalid.
- `401`: Missing or invalid Bearer access token.
- `402`: The authorised Fleetkeep account does not currently have active product access.
- `403`: Token does not include the required scope.
- `404`: The requested resource does not exist on the authorised user's account, is the wrong event type, or is immutable history for this operation.
- `429`: Per-token rate limit exceeded (60 requests per minute).
- `500`: The API authentication or database service is not configured.
- `502`: An authorised external provider could not return or accept the requested operation.
- `503`: A required private storage, provider configuration or service dependency is unavailable.

---

[API](https://skmtc.dev/fleetkeep/apis/fleetkeep-api.md) · [All operations](https://skmtc.dev/fleetkeep/apis/fleetkeep-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fleetkeep/apis/fleetkeep-api/revisions/ace19bc0d64d?raw)