External Integration API
Historical Active Units — External Integration API
Enables partners to identify vehicles that were active within a requested date range. The maximum supported time window is 72 hours.
Platform
| Base Read API URL |
|---|
https://read.rulereld.com |
Authentication
Two headers are required for every request:
| Header | Required | Purpose |
|---|---|---|
x-api-key | Yes | API key |
provider-token | Yes | Provider authentication token |
Endpoint
GET/api/externalservice/active-units/:usdot/?from={date}&to={date}
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
usdot | Path | Yes | Company USDOT number |
from | Query | Yes | Start timestamp (ISO 8601) |
to | Query | Yes | End timestamp (ISO 8601) |
72-Hour LimitThe maximum date range is 72 hours. The
from and to timestamps must not span more than 72 hours.Example Request URL
bash
GET https://read.rulereld.com/api/externalservice/active-units/123456/
?from=2026-01-10T00:00:00.000Z&to=2026-01-13T00:00:00.000ZResponse Structure
Returns an array of unit objects for all vehicles that were active within the requested time range.
json
[
{
"id": "string",
"truck_number": "string",
"vin": "string"
}
]Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique vehicle identifier |
truck_number | string | The truck's assigned number |
vin | string | Vehicle Identification Number |
Example cURL Request
bash
curl --location 'https://read.rulereld.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>'Contact the support team for access credentials or integration assistance.