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": "00000000-0000-0000-0000-000000000001",
      "power_unit_number": "unit001",
      "make": "PETERBILT",
      "model": "579",
      "year": 2022,
      "license_plate_no": "ABC1234",
      "vin": "1XPBD49X0ND000001"
    }
  ],
  "drivers": [
    {
      "guid": "00000000-0000-0000-0000-000000000002",
      "username": "driver01",
      "profile": {
        "profile_picture": null,
        "first_name": "John",
        "last_name": "Smith",
        "email": "driver01@example.com",
        "phone_number": "5550001234"
      }
    }
  ],
  "location_data": [
    {
      "vehicle_id": "unit001",
      "make": "PETERBILT",
      "model": "579",
      "year": 2022,
      "vin": "1XPBD49X0ND000001",
      "odometer": 124500,
      "start_point": "3.2 mi W of Nashville, TN",
      "speed": 0.0,
      "coordinates": [
        {
          "latitude": 36.16589,
          "longitude": -86.7844,
          "associated_date": "2025-08-15T10:22:00.000000Z",
          "driver_guid": "00000000-0000-0000-0000-000000000002"
        }
      ]
    }
  ]
}

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
`profile.first_name`	string	First name
`profile.last_name`	string	Last name
`profile.email`	string	Email address
`profile.phone_number`	string	Phone number
`profile.profile_picture`	string \| null	Avatar URL or null

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
`odometer`	number	Total mileage in miles
`start_point`	string	Human-readable current location
`speed`	number	Current speed in mph
`coordinates`	array	GPS coordinates — see below

coordinates[ ] object

Field	Type	Description
`latitude`	number	Latitude in decimal degrees
`longitude`	number	Longitude in decimal degrees
`associated_date`	string (ISO 8601)	UTC timestamp of this GPS reading
`driver_guid`	string (UUID)	GUID of the driver at this coordinate — matches drivers[].guid

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