API reference
Tracking API
Real-time location and delivery status.
Stream and query live location and status for in-flight deliveries. Power your own tracking views, or push location updates from your devices into the FOODS customer experience.
Capabilities
- Push rider location updates
- Query live status for any active order
- Retrieve a delivery’s route and timestamps
- Surface ETAs to customers and creators
Endpoints
POST
/v1/tracking/{order_id}/locationPush a location ping
GET
/v1/tracking/{order_id}Get live tracking state
Push a location update
Request
curl -X POST https://api.foodsbyme.com/v1/tracking/ord_8Kd2/location \
-H "Authorization: Bearer $FOODS_PARTNER_KEY" \
-H "Content-Type: application/json" \
-d '{ "lat": 6.4361, "lng": 3.4847, "heading": 118, "speed_kph": 24 }'Response · 200 OK
{
"order_id": "ord_8Kd2",
"status": "in_transit",
"location": { "lat": 6.4361, "lng": 3.4847 },
"eta_mins": 6,
"distance_remaining_km": 1.8
}