Skip to main content

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:

PlanRequests/minuteRequests/day
Standard6010,000
Enterprise300100,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​

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

Pagination​

List endpoints support pagination via query parameters:

ParameterTypeDefaultDescription
pageinteger1Page number
limitinteger10Items per page (max 100)
searchstring—Search filter

Example:

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