Push API: We Send Data to Your Server
New data arrives at your endpoint as devices report.
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 Push
- You need data the moment it arrives
- You want to avoid constant polling
- Your system can receive incoming requests over HTTPS
What you build
- An HTTPS endpoint that accepts POST
- A check of the API key on every request
- A reply with success true after you save the data
- A way to ignore duplicates
Questions we hear often
What if my endpoint is down?
Keep it available. Ask us how retries work for your setup.
Can we change the header name?
Yes. It is agreed with you.