MDM API Documentation

Getting Started

To use the API, you need an API key. Get it from your dashboard:

Log in to your account dashboard
Navigate to the "API Keys" section in the sidebar
Click the "Create API Key" button
Copy the generated API key

Authentication

All API requests require the api_key query parameter:

curl "https://api.mdm-eld.com/api/web/v1/vehicle/coordinates/?api_key=your_api_key_here"

API Endpoints

GET/api/web/v1/vehicle/coordinates/

Get real-time vehicle coordinates and information for all vehicles in your fleet.

Query Parameters

Parameter	Type	Description
`api_key`*	string	Your API authentication key
`vehicle_id`	string	Filter by vehicle ID (e.g. unit82427)
`vin`	string	Filter by VIN (e.g. 1XPBDP9X8RD655257)

* Required parameter

Example Request

All vehicles:

curl -X GET "https://api.mdm-eld.com/api/web/v1/vehicle/coordinates/?api_key=your_api_key_here"

By Vehicle ID:

curl -X GET "https://api.mdm-eld.com/api/web/v1/vehicle/coordinates/?api_key=your_api_key_here&vehicle_id=11111"

By VIN:

curl -X GET "https://api.mdm-eld.com/api/web/v1/vehicle/coordinates/?api_key=your_api_key_here&vin=3AKJHHDR5HSHA333"

Example Response

[
  {
    "vehicle_id": "unit82427",
    "make": "PETERBILT",
    "model": "579",
    "year": 2024,
    "vin": "1XPBDP9X8RD655257",
    "odometer": 356802,
    "start_point": "4.91 mi N of Palmyra, NJ",
    "speed": 49.0,
    "coordinates": [
      {
        "latitude": "40.07090180000000",
        "longitude": "-75.01049680000000",
        "associated_date": "2025-11-17T13:52:15.797996Z"
      }
    ]
  }
]

Response Fields

Field	Type	Description
`vehicle_id`	string	Unique identifier for the vehicle
`make`	string	Vehicle manufacturer
`model`	string	Vehicle model
`year`	number	Manufacturing year
`vin`	string	Vehicle Identification Number
`odometer`	number	Current odometer reading in miles
`start_point`	string	Current location description
`speed`	number	Current speed in mph
`coordinates`	array	Array of coordinate objects with latitude, longitude, and timestamp

GET/api/web/v1/vehicle/coordinates/location-data/

Get comprehensive fleet data including vehicles, drivers, and location information.

Query Parameters

Parameter	Type	Description
`api_key`*	string	Your API authentication key

* Required parameter

Example Request

curl -X GET "https://api.mdm-eld.com/api/web/v1/vehicle/coordinates/location-data/?api_key=your_api_key_here"

Example Response

{
  "vehicles": [
    {
      "guid": "07eefcd4-bf2f-4185-a831-4873341f6ad6",
      "power_unit_number": "gentra",
      "make": "Chevrolet",
      "model": "Lacetti",
      "year": 2020,
      "license_plate_no": "072",
      "vin": "072827"
    }
  ],
  "drivers": [
    {
      "guid": "47a605ba-f94c-436d-953e-4873276b31d8",
      "username": "leomessi",
      "profile": {
        "profile_picture": null,
        "first_name": "Leo",
        "last_name": "Messi",
        "email": "",
        "phone_number": ""
      }
    }
  ],
  "location_data": [
    {
      "vehicle_id": "gentra",
      "vin": "072827",
      "odometer": 0,
      "start_point": "4818.19 mi E of Iqaluit, NU",
      "speed": 0.0,
      "coordinates": [
        {
          "latitude": "41.31693096313481",
          "longitude": "69.24107647911877",
          "associated_date": "2025-08-25T13:30:47.071666Z"
        }
      ]
    }
  ]
}

Response Structure

Vehicles Array

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

Drivers Array

Field	Type	Description
`guid`	string	Unique driver identifier
`username`	string	Driver username
`profile`	object	Driver profile information (name, email, phone)

Location Data Array

Field	Type	Description
`vehicle_id`	string	Vehicle identifier
`vin`	string	Vehicle Identification Number
`odometer`	number	Current odometer reading
`start_point`	string	Current location description
`speed`	number	Current speed
`coordinates`	array	GPS coordinates with timestamp

Error Codes

The API uses standard HTTP status codes to indicate success or failure of requests:

200

Request completed successfully

400

Bad Request

Invalid request format

401

Unauthorized

Invalid or missing API key

404

Not Found

Resource not found

429

Too Many Requests

Rate limit exceeded

500

Internal Server Error

Internal server error

Rate Limits

The API has the following limits to prevent abuse:

1000 requests per hour per API key
Maximum 100 items per page for pagination
Request body size limited to 1 MB