BRTA GPS Tracking API Documentation | Developed by Truck Lagbe

Introduction

Welcome to the official technical documentation for the Bangladesh Road Transport Authority (BRTA) GPS Tracking API (v1.0). This platform allows certified GPS service providers and enterprise fleet managers to push and pull real-time vehicle telemetry metrics.

⚡ Developer Attribution

This integration suite and API engine were developed by Truck Lagbe for official integration with the BRTA GPS Monitoring Platform.

1. Get Current Vehicle Location

Fetch real-time location, speed, engine ignition status, and direction metrics for a registered vehicle.

GET https://api.abc.com/v1/vehicles/current-location

2. Request Query Parameters

Every request to the /current-location endpoint must include the following mandatory parameters in the query string:

Parameter	Type	Required	Description	Example
organization_id	String	REQUIRED	Unique identifier assigned to your organization by BRTA.	`ORG123456789`
vehicle_id	String	REQUIRED	Unique Vehicle Tracking Identifier or GPS Device IMEI Number.	`862292051507267`
email	String	REQUIRED	Registered administrator email associated with the organization.	`demo@abc.com`
api_key	String	REQUIRED	Secret authentication key granted during vendor registration.	`secret_api_key_123`

Example Request URL cURL

curl -X GET "https://api.abc.com/v1/vehicles/current-location?organization_id=ORG123456789&vehicle_id=862292051507267&email=demo@abc.com&api_key=secret_api_key_123"   -H "Accept: application/json"

3. Response Structure

Upon success, the API returns an HTTP 200 OK with a standardized JSON object containing the vehicle's telemetry data.

Sample HTTP 200 Response Payload JSON

{
  "success": true,
  "message": "Current vehicle location fetched successfully.",
  "data": {
    "vehicle_id": "862292051507267",
    "vehicle_type": "Dhaka Metro-GA-12-3456",
    "ignition_status": "ON",
    "speed": 48,
    "heading": 180,
    "timestamp": "2026-07-28T10:35:21Z",
    "location": {
      "latitude": 23.810331,
      "longitude": 90.412521
    }
  }
}

Field	Data Type	Description
success	Boolean	Request processing status (`true` or `false`).
message	String	Human-readable response message.
data.vehicle_id	String	Unique IMEI / Device ID matched.
data.vehicle_type	String	Vehicle BRTA Registration Number / Device Model.
data.ignition_status	String	State of engine ignition: `ON`, `OFF`, or `UNAVAILABLE`.
data.speed	Number	Speed of vehicle in kilometers per hour (km/h).
data.heading	Number	Compass orientation angle in degrees (0° - 360°).
data.timestamp	String	Date and time of GPS fix in UTC ISO 8601 format.
data.location.latitude	Number	Latitude coordinate in WGS84 format.
data.location.longitude	Number	Longitude coordinate in WGS84 format.

4. HTTP Status Codes

Code	Status Text	Description
200	OK	Vehicle metrics returned successfully.
400	Bad Request	Missing mandatory query parameters in request.
401	Unauthorized	Invalid `api_key`, `organization_id`, or `email`.
404	Not Found	No matching vehicle or IMEI found in database.