Trackings - External Integration API

Overview

This document describes the External Integration API that provide access to historical tracking data between the any given date range of maximum 72 hours. Collectively, this endpoint enable partners to:

• Retrieve detailed historical tracking data for vehicles

Platform

• Base Read API URL: https://read.tteld.com

Authentication

API requests must include the following headers:

Trackings

Returns detailed telemetry data for a specific vehicle within a defined time range. Data is returned in chronological order.

Endpoint

GET /api/externalservice/trackings/:usdot/:vehicleId/?from={date}&to={date}

Query Parameters

• usdot(required): Company USDOT
• vehicleId (required): Vehicle ID
• from (required): Start timestamp
• to (required): End timestamp

Example Request

GET https://read.tteld.com/api/externalservice/trackings/123456/9b92e12c-deda-49ac-9a0d-9asd9213kaed/?from=2026-01-10T00:00:00.000Z&to=2026-01-13T00:00:00.000Z

Response

[
  {
    "address": "string",
    "coordinates": {
      "lat": 0.0,
      "lng": 0.0
    },
    "rotation": 0,
    "speed": 0,
    "driverId": "string",
    "odometer": 0,
    "date": "ISO 8601 string"
  }
]

Example cURL Request

Tracking

curl --location 'https://read.tteld.com/api/externalservice/trackings/123456/4ff9f479-7794-431a-b8a6-a3s2da5wqea6/?from=2026-01-10T00:00:00.000Z&to=2026-01-13T00:00:00.000Z' \
--header 'x-api-key: <your-api-key>' \
--header 'provider-token: <your-provider-token>'

Summary

Using this endpoint together allows integrators to:

• Retrieve detailed historical tracking data for auditing or analysis

For access credentials or further integration support, please contact the support team.