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

# Introduction

> Overview of the Telemax External API for fleet telemetry, vehicle commands, and integrations.

The **Telemax External API** is a standalone ASP.NET Core REST service that exposes fleet operations to third-party systems and mobile clients. It provides JWT-based access to live and historical vehicle positions, trip replays with map-ready polylines, company-scoped fleet snapshots, alerts, battery health predictions, and remote commands (odometer, rename, and location workflows).

## Who it's for

* **Integration partners** building billing, dispatch, or analytics on top of Telemax fleet data.
* **Mobile and backend clients** that authenticate with company API keys.
* **Operators and developers** maintaining automation against the same contracts as the legacy Telemax integration surface.

## Key capabilities

* **Authentication**: API key returning a **Bearer JWT** with company, timezone, and optional vehicle and action claims.
* **Telemetry**: last position, historical positions, trip replay (UTC or user-time-oriented callers), IMEI lookup, nearest-vehicle search, and fleet-wide snapshots.
* **Commands**: odometer update, vehicle rename, and location update handoff (where IMEI exists).
* **Alerts**: list alerts with reverse geocoding, mark one or all as read for permitted companies.
* **Insights**: paged battery health predictions.
* **Diagnostics**: latest engine codes from vehicle handler state.

<Note>
  **RESTful design:** V2 endpoints follow standard RESTful HTTP methods (`GET`, `POST`, `PUT`, `DELETE`) with parameters passed in the path or query string. A small number of endpoints still use `POST` where the parameter set is too large for a query string — see [Which endpoint do I need?](/v2/which-endpoint) for per-endpoint details.
</Note>

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/v2/quickstart">
    Obtain a JWT and call your first authenticated route.
  </Card>

  <Card title="API Reference" icon="code" href="/v2/api-reference/post-authentication-token-api-key">
    Endpoint guides with interactive Try it for each route—start with authentication.
  </Card>
</CardGroup>

## Guides

<CardGroup cols={2}>
  <Card title="Real-Time Fleet Tracking" icon="map" href="/v2/which-endpoint">
    Find the right endpoint for polling fleet positions and tracking live vehicle locations.
  </Card>

  <Card title="Trip Replay" icon="route" href="/v2/guides/trip-replay">
    Fetch trip waypoints, decode polylines, and render on Google Maps or Leaflet.
  </Card>

  <Card title="Alert Monitoring" icon="bell" href="/v2/guides/alert-monitoring">
    Poll, filter, and acknowledge alerts in a stateful pipeline.
  </Card>

  <Card title="Vehicle Health Dashboard" icon="heart-pulse" href="/v2/guides/vehicle-diagnostics">
    Combine position, battery health, and engine codes into a single dashboard view.
  </Card>
</CardGroup>