ERETH ELD — API Documentation | ELD Provider REST API v1.0

Section 1

Overview

The ERETH ELD REST API provides real-time access to vehicle locations, driver Hours of Service (HOS) data, and fleet status for carriers using the ERETH ELD system. This API is designed for integration with Highway and other third-party platforms.

ELD Provider	ERETH ELD
FMCSA ELD ID	ERS238
Base URL	https://eretheld.com/api/v1
Authentication	Bearer token in Authorization header
Format	JSON — all requests and responses
Encoding	UTF-8
Timestamps	ISO 8601 / UTC (e.g. 2026-08-04T21:49:07.000Z)
Coordinates	Decimal degrees — WGS84 (latitude, longitude)

ℹ All data is scoped to the carrier associated with your API key. A single key cannot access data from other carriers.

Section 2

Authentication

Each carrier generates a unique API key from the Fleet Admin Panel. Include the key as a Bearer token in the Authorization header on every request.

Request Header

Authorization: Bearer {api_key}

Example — cURL

curl -H "Authorization: Bearer ereth_live_xxxx" \
  https://eretheld.com/api/v1/vehicles

⚠ API keys are shown only once at generation time. Store them securely. If a key is lost or compromised, generate a new one from the Fleet Admin Panel and revoke the old key immediately.

Section 3

Endpoints

GET /api/v1/ping Health Check

No Auth Required

Returns the provider status and identity. Use this endpoint to verify connectivity and confirm the ELD provider identifier before integration.

Response 200

{
  "provider":    "ERETH ELD",
  "identifier":  "ERS238",
  "version":     "2.0",
  "status":      "ok",
  "timestamp":   "2026-08-04T21:00:00.000Z"
}

GET /api/v1/vehicles All Vehicles

Bearer Token Required

Returns all active vehicles for the carrier associated with the API key, including current GPS position, assigned driver, and HOS duty status.

Example — cURL

curl -H "Authorization: Bearer ereth_live_xxxx" \
  https://eretheld.com/api/v1/vehicles

Response 200

{
  "vehicles": [
    {
      "company_id":     1,
      "carrier_name":   "Example Carrier LLC",
      "dot_number":     "1234567",
      "mc_number":      "MC-1234567",
      "truck_number":   "UNIT-22",
      "vin":            "1FUJGBDV8CLBP8566",
      "make":           "Freightliner",
      "model":          "Cascadia",
      "year":           2022,
      "license_plate":  "IL 456789",
      "license_state":  "IL",
      "status":         "active",
      "lat":            41.4993,
      "lng":            -81.6944,
      "timestamp":      "2026-08-04T21:49:07.000Z",
      "driver_name":    "John Smith",
      "duty_status":    "D",
      "odometer":       125597,
      "engine_hours":   1248.5
    }
  ],
  "count": 1
}

Field	Type	Description
company_id	integer	Internal carrier ID
carrier_name	string	Carrier company name
dot_number	string	FMCSA DOT number
mc_number	string\|null	MC number (if applicable)
truck_number	string	Unit/truck identifier
vin	string	Vehicle identification number
lat / lng	float\|null	Last GPS coordinates (WGS84)
timestamp	string\|null	Last GPS ping — ISO 8601 UTC
driver_name	string\|null	Currently assigned driver full name
duty_status	string\|null	HOS duty status: `D`, `SB`, `ON`, `OFF`
odometer	integer\|null	Odometer reading in miles
engine_hours	float\|null	Total engine hours (2 decimal places)

GET /api/v1/vehicles/{vin}/location Single Vehicle

Bearer Token Required URL Param: vin

Returns the current location and status for a specific vehicle identified by VIN. The vehicle must belong to the carrier associated with the API key.

Parameter	In	Description
vin	URL path	17-character vehicle identification number

Example — cURL

curl -H "Authorization: Bearer ereth_live_xxxx" \
  https://eretheld.com/api/v1/vehicles/1FUJGBDV8CLBP8566/location

Response 200

{
  "company_id":   1,
  "truck_number": "UNIT-22",
  "vin":          "1FUJGBDV8CLBP8566",
  "lat":          41.4993,
  "lng":          -81.6944,
  "timestamp":   "2026-08-04T21:49:07.000Z",
  "driver_name": "John Smith",
  "duty_status": "D",
  "odometer":    125597,
  "engine_hours": 1248.5,
  "dot_number":  "1234567",
  "mc_number":   "MC-1234567"
}

GET /api/v1/drivers All Drivers

Bearer Token Required

Returns all drivers associated with the carrier, including their current vehicle assignment, duty status, and last activity timestamp.

Example — cURL

curl -H "Authorization: Bearer ereth_live_xxxx" \
  https://eretheld.com/api/v1/drivers

Response 200

{
  "drivers": [
    {
      "id":                   "jsmith",
      "name":                 "John Smith",
      "license_number":       "D0000123456",
      "license_state":        "IL",
      "status":               "active",
      "current_vehicle_vin":  "1FUJGBDV8CLBP8566",
      "duty_status":          "D",
      "last_activity":        "2026-08-04T20:00:00.000Z"
    }
  ]
}

Field	Type	Description
id	string	Driver username / identifier
name	string	Full name (first + last)
license_number	string	CDL license number
license_state	string	State that issued the CDL
status	string	`active` or `inactive`
current_vehicle_vin	string\|null	VIN of currently assigned vehicle
duty_status	string	Current HOS duty status
last_activity	string	Last recorded activity — ISO 8601 UTC

GET /api/v1/hos/{driver_id} Driver HOS

Bearer Token Required URL Param: driver_id

Returns the current Hours of Service summary for a specific driver, including drive time used and remaining, shift totals, and 7/8 day cycle data.

Parameter	In	Description
driver_id	URL path	Numeric driver ID (from the drivers list)

Example — cURL

curl -H "Authorization: Bearer ereth_live_xxxx" \
  https://eretheld.com/api/v1/hos/1

Response 200

{
  "driver_id":          1,
  "driver_name":        "John Smith",
  "cycle":              "property_70_8",
  "drive_used":         8.0,
  "drive_remaining":    3.0,
  "shift_used":         9.0,
  "shift_remaining":    5.0,
  "cycle_used":         42.5,
  "cycle_remaining":    27.5,
  "duty_status":        "D",
  "last_status_change": "2026-08-04T06:30:00.000Z"
}

Field	Type	Description
cycle	string	HOS rule: `property_60_7` or `property_70_8`
drive_used	float	Drive hours used in current shift
drive_remaining	float	Drive hours remaining (max 11h)
shift_used	float	On-duty hours used in current shift
shift_remaining	float	On-duty hours remaining (max 14h)
cycle_used	float	Hours used in 7/8 day cycle
cycle_remaining	float	Hours remaining in cycle
duty_status	string	`D` Driving, `ON` On Duty, `SB` Sleeper Berth, `OFF` Off Duty

Section 4

Error Responses

All errors return JSON with an error field describing the problem. HTTP status codes follow standard conventions.

Status	Error Message	Cause
401	`API key required`	No `Authorization` header sent
401	`Invalid or revoked API key`	Key does not exist or has been revoked
404	`Vehicle not found`	VIN not found or belongs to a different carrier
404	`Driver not found`	Driver ID not found or belongs to a different carrier
500	`Internal server error`	Unexpected server-side failure

Error Response Format

// 401 Unauthorized
{ "error": "API key required" }

// 404 Not Found
{ "error": "Vehicle not found" }

// 500 Server Error
{ "error": "Internal server error" }

Section 5

Carrier API Key Setup

Each carrier gets their own unique API key. Fleet managers generate keys directly from the ERETH ELD Admin Panel — no technical setup required.

1

Fleet manager logs in at eretheld.com/admin-panel/

2

Navigate to Carriers → select the carrier → click API Keys

3

Click Generate New Key

4

Copy the generated key — it is shown only once. Store it securely.

5

Provide the key to Highway during carrier onboarding

ℹ Keys can be revoked at any time from the Admin Panel. Revoked keys return HTTP 401 immediately. Generate a new key and update Highway if a key needs to be rotated.

Section 6

Test Credentials

Use these credentials to test the Highway integration before going live with a real carrier. The test carrier has two active vehicles with live GPS data.

Test API Key ereth_live_f603c7ecce7d470e6aa7b34118ca287d

Test Carrier DOT 4323811

Test Vehicle 1 VIN 1FUJGBDV8CLBP8566

Test Vehicle 2 VIN 3AKJHHDR4LSLN1234

Example — Test all vehicles

curl -H "Authorization: Bearer ereth_live_f603c7ecce7d470e6aa7b34118ca287d" \
  https://eretheld.com/api/v1/vehicles

Example — Single vehicle location

curl -H "Authorization: Bearer ereth_live_f603c7ecce7d470e6aa7b34118ca287d" \
  https://eretheld.com/api/v1/vehicles/1FUJGBDV8CLBP8566/location

Section 7

Contact & Support

For integration support, technical questions, or to report API issues, reach out through any of the channels below.

Technical Support

info@eretheld.com

Provider

eretheld.com

FMCSA ELD Registry

eld.fmcsa.dot.gov