Historical Active Units - External Integration API

Overview

This document describes the External Integration API that provide access to active units between the any requested date range of maximum 72 hours. Collectively, this endpoint enable partners to:

• Identify vehicles that were active within a specific time range

Platform

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

Authentication

API requests must include the following headers:

Endpoint

Historical Active Units

Returns a list of units that were active within a specified time range.

Endpoint

GET /api/externalservice/active-units/:usdot/?from={date}&to={date}

Query Parameters

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

Example Request

GET https://read.tteld.com/api/externalservice/active-units/123456/?from=2026-01-10T00:00:00.000Z&to=2026-01-13T00:00:00.000Z

Response

[
  {
    "id": "string",
    "truck_number": "string",
    "vin": "string"
  }
]

Example cURL Request

Historical Active Units

curl --location 'https://read.tteld.com/api/externalservice/active-units/123456/?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:

• Identify vehicles active within a specific time window

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