Getting Started

Welcome to the Motion ELD API. This guide will help you integrate with our fleet management platform.

Base URL

All API requests should be made to:

https://api-gateway.motioneld.com/api

Authentication

The Motion ELD API uses API key authentication. Include your API key in the X-API-Key header:

curl -X GET "https://api-gateway.motioneld.com/api/drivers" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Obtaining an API Key

1. Log in to your Motion ELD admin dashboard
2. Navigate to Settings → API Keys
3. Click Generate API Key
4. Copy and securely store your API key

caution

Keep your API key secure. Do not expose it in client-side code or public repositories.

Rate Limiting

API requests are rate-limited to ensure fair usage:

Plan	Requests/minute	Requests/day
Standard	60	10,000
Enterprise	300	100,000

Rate limit headers are included in every response:

• X-RateLimit-Limit — Maximum requests allowed
• X-RateLimit-Remaining — Requests remaining
• X-RateLimit-Reset — Time until limit resets (Unix timestamp)

Response Format

All responses are JSON. Successful responses include the data directly:

{
  "count": 25,
  "items": [...]
}

Error responses follow this format:

{
  "code": "UNAUTHORIZED",
  "message": "Invalid API key",
  "data": null
}

Common HTTP Status Codes

Code	Description
200	Success
400	Bad Request — Invalid parameters
401	Unauthorized — Invalid or missing API key
403	Forbidden — Insufficient permissions
404	Not Found
429	Too Many Requests — Rate limit exceeded
500	Internal Server Error

Pagination

List endpoints support pagination via query parameters:

Parameter	Type	Default	Description
page	integer	1	Page number
limit	integer	10	Items per page (max 100)
search	string	—	Search filter

Example:

GET /api/drivers?page=2&limit=25&search=john