API Docs

vDrive Delivery Status

vGrubs calls you

POST{your_base_url}/orders/delivery

vGrubs calls this endpoint to push real-time delivery status updates for orders fulfilled by vDrive - vGrubs' own delivery service. Implement this endpoint to track driver location, delivery progress, and courier details.

Request body

order_idstringrequired

Partner order ID - same value sent in the original order payload.

statusstringrequired

Current delivery status. Never null.

pendingNo driver assigned yet - waiting for assignment

assignedDriver has been assigned

startedDelivery started - driver heading to restaurant

picked_upDriver picked up order, heading to customer

arrivingDriver arriving at dropoff location

deliveredOrder delivered

cancelledDelivery cancelled

tracking_linkstring / null

Live tracking URL.

distance_milesnumber / null

Total delivery distance in miles.

cancellation_reasonstring / null

Reason for cancellation, if applicable.

pickup_etastring / null

Estimated driver arrival at restaurant (ISO 8601).

dropoff_etastring / null

Estimated delivery to customer (ISO 8601).

courierobjectrequired

Courier details.

driver_locationobject / null

Live driver coordinates. null until driver location becomes available.

timestampsobject

Delivery lifecycle timestamps.

Responses

200OK

successboolean

Whether the delivery update was received successfully.

400Bad Request

Missing or invalid fields in the request body.

401Unauthorized

Invalid or missing API key.

# vGrubs sends this request to your API. Run it against your server to test your implementation.
curl --request POST \
  --url https://api.yourplatform.com/orders/delivery \
  --header 'content-type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
  "order_id": "ord_12345",
  "status": "assigned",
  "tracking_link": "https://track.vgrubs.com/abc123",
  "distance_miles": 2.4,
  "cancellation_reason": null,
  "pickup_eta": "2026-05-25T10:15:00.000Z",
  "dropoff_eta": "2026-05-25T10:35:00.000Z",
  "courier": {
    "name": "Mike Rider",
    "photo_url": "https://example.com/courier.jpg",
    "phone_number": "+14155550199",
    "status": "assigned"
  },
  "driver_location": {
    "latitude": 40.7128,
    "longitude": -74.006
  },
  "timestamps": {
    "assigned_at": "2026-05-25T10:05:00.000Z",
    "arrived_pickup_at": null,
    "picked_up_at": null,
    "arrived_dropoff_at": null,
    "delivered_at": null,
    "cancelled_at": null
  }
}'

Credentials

API key

Partner name

Your API base URL

Credentials are stored only in this browser.

vGrubs sends this request to your API as events occur. Enter your public API base URL above and Try It delivers this exact payload to your server, so you can test your implementation live.

Request body

Enter your API base URL above to send the test request.

Response

200 OK

{
  "success": true
}