Pull API: Get Vehicle Data on Demand
Your system asks. We answer with the latest data.
WhatsApp Now Get a QuoteFormat
Pull vehicle data on demand
| Method | GET |
| Endpoint | https://YOUR-PLATFORM-DOMAIN/api/get_current_data |
| Auth | Query parameters: token and email |
| Parameters | token (required), email (required) |
| Returns | Array of current vehicle objects, in JSON |
The Pull API returns the latest known data for the vehicles on your account: location, speed, ignition, vehicle status, address and device details. Call it whenever your system needs the current state.
Sample request
curl "https://YOUR-PLATFORM-DOMAIN/api/get_current_data?token=YOUR_API_TOKEN&email=YOUR_EMAIL"
Sample response, 200
[{"reg_no":"AP00XX0000","latitude":16.9891,"longitude":82.2475,"speed":0,"bearing":44,"ignition_status":"ON","vehicle_status":"NODATA","address":"Sample address","odo_distance":2623.63,"fuel_litre":0,"inside_geofence":"N","vehicle_type":"EARTH-MOVER","device_id":"000000000000"}]Receive data pushed to your server
| Method | POST |
| Endpoint | Your server URL. You share it with us |
| Headers | Content-Type: application/json, and an API key header such as X-Api-Key: YOUR_API_KEY. The header name is agreed with you |
| Body | JSON array of vehicle data objects |
| Success | Treated as successful only when the response has success set to true |
We push new GPS data to your endpoint as devices report. Check the key on every request, and reply with success true only after you have stored the data.
Sample request body
POST https://YOUR-SERVER/your-endpoint
Content-Type: application/json
X-Api-Key: YOUR_API_KEY
[{"latitude":16.9891,"longitude":82.2475,"speed":0,"date":1749665036599,"iso_date":"2025-06-11T18:03:56.599Z","odo_distance":2623.63,"ignition_status":"ON","status":"ON","vehicle_status":"NODATA","address":"Sample address","reg_no":"AP00XX0000","vehicle_type":"EARTH-MOVER","vehicle_id":"SAMPLE01","device_id":"000000000000","expiry_date":"2026-12-31"}]Success response, 200
{"success":true,"statusMessage":"Ok."}Error response, 4xx
{"message":"Unauthorized","http_status_code":401}When to use Pull
- Dashboards that refresh every few seconds or minutes
- Reports built once a day
- Systems that cannot receive incoming requests
Good practice
- Poll no faster than you need
- Store the token on your server, not in a web page
- Handle 401 and 403 responses
- Save the time of the last read
Questions we hear often
How often can I call it?
Usage limits apply. A key at its limit gets a 403.
Is the data live?
It is the latest known position reported by the device.