Luna ELD API Documentation

Base URL

https://api.lunaeld.us

Authentication

Pass your API key as a query parameter on every request:

?api_key=your_api_key

Endpoints

GET

/api/web/v1/trucker-cloud/coordinates/

Fleet snapshot: vehicles, drivers, and GPS location data with optional date range filtering.

GET/api/web/v1/trucker-cloud/coordinates/

Returns a complete fleet snapshot: all registered vehicles, all drivers, and GPS location data for each vehicle. Use start_date and end_date to filter coordinate history within a time window. Each coordinate entry includes a driver_guid linking to the driver from the drivers array.

Query Parameters

Parameter	Type	Description
`api_key`*	string	Your API key
`start_date`	datetime	Start of history window — format: YYYY-MM-DD HH:MM:SS
`end_date`	datetime	End of history window — format: YYYY-MM-DD HH:MM:SS

* Required. Omit date params to get current data only.

Example Requests

Current fleet data:

curl "https://api.lunaeld.us/api/web/v1/trucker-cloud/coordinates/?api_key=your_api_key"

With date range filter:

curl "https://api.lunaeld.us/api/web/v1/trucker-cloud/coordinates/?api_key=your_api_key&start_date=2025-08-01+00:00:00&end_date=2025-08-08+23:59:59"

Example Response

{
  "vehicles": [
    {
      "guid": "11111111-2222-3333-4444-555555555555",
      "power_unit_number": "TRK-001",
      "make": "FREIGHTLINER",
      "model": "Cascadia",
      "year": 2023,
      "license_plate_no": "ABC1234",
      "vin": "1HGBH41JXMN109186"
    }
  ],
  "drivers": [
    {
      "guid": "66666666-7777-8888-9999-000000000000",
      "username": "driver01",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "phone_number": "+15551234567",
      "license_number": "DL123456789",
      "license_state": "TX"
    }
  ],
  "location_data": [
    {
      "vehicle_id": "TRK-001",
      "make": "FREIGHTLINER",
      "model": "Cascadia",
      "year": 2023,
      "vin": "1HGBH41JXMN109186",
      "license_plate": "ABC1234",
      "device_id": "ELD123456789",
      "device_type": "ELD",
      "driver_guid": "66666666-7777-8888-9999-000000000000",
      "odometer": 125000,
      "speed": 62.5,
      "start_point": "Dallas, TX",
      "last_tracking_activity": "2026-06-01T12:00:00Z",
      "last_known_location": {
        "latitude": 32.7767,
        "longitude": -96.7970
      },
      "coordinates": [
        {
          "latitude": 32.7800,
          "longitude": -96.8000,
          "speed": 65,
          "odometer": 124950,
          "timestamp": "2026-06-01T11:45:00Z",
          "driver_guid": "66666666-7777-8888-9999-000000000000",
          "driver_name": "John Doe",
          "vehicle_id": "TRK-001",
          "timezone": "US/Central"
        }
      ]
    }
  ]
}

Response Structure

vehicles[ ]

Field	Type	Description
`guid`	string (UUID)	Unique vehicle identifier
`power_unit_number`	string	Vehicle unit number
`make`	string	Manufacturer
`model`	string	Vehicle model
`year`	number	Manufacturing year
`license_plate_no`	string	License plate number
`vin`	string	Vehicle Identification Number

drivers[ ]

Field	Type	Description
`guid`	string (UUID)	Unique driver identifier — matches driver_guid in coordinates
`username`	string	Driver login username
`first_name`	string	First name
`last_name`	string	Last name
`email`	string	Email address
`phone_number`	string	Phone number
`license_number`	string	Driver license number
`license_state`	string	License issuing state

location_data[ ]

Field	Type	Description
`vehicle_id`	string	Matches power_unit_number from vehicles[]
`make`	string	Manufacturer
`model`	string	Vehicle model
`year`	number	Manufacturing year
`vin`	string	Vehicle Identification Number
`license_plate`	string	License plate number
`device_id`	string	Tracking device identifier
`device_type`	string	Device type (e.g. ELD)
`driver_guid`	string (UUID)	GUID of assigned driver — matches drivers[].guid
`odometer`	number	Total mileage in miles
`speed`	number	Current speed in mph
`start_point`	string	Human-readable current location
`last_tracking_activity`	string (ISO 8601)	UTC timestamp of last tracking activity
`last_known_location`	object	Last known position — { latitude, longitude }
`coordinates`	array	GPS coordinates — see below

coordinates[ ] object

Field	Type	Description
`latitude`	number	Latitude in decimal degrees
`longitude`	number	Longitude in decimal degrees
`speed`	number	Speed at this reading in mph
`odometer`	number	Odometer reading in miles
`timestamp`	string (ISO 8601)	UTC timestamp of this GPS reading
`driver_guid`	string (UUID)	GUID of the driver at this coordinate — matches drivers[].guid
`driver_name`	string	Driver full name
`vehicle_id`	string	Matches power_unit_number from vehicles[]
`timezone`	string	Timezone of the reading (e.g. US/Central)

HTTP Status Codes

200

Request successful

400

Bad Request

Invalid query parameter or format

401

Unauthorized

Missing or invalid api_key

404

Not Found

Resource not found

429

Too Many Requests

Rate limit exceeded, slow down

500

Server Error

Internal error, try again later