Post location ping

POST {{baseUrl}}/runners/location

Reports the driver’s current GPS location while on shift. Source: util/background_geolocation.ts.

Response: 200, plain-text body Location updated successfully. Not JSON — no fields to document.

Request body

{
  "location": {
    "coords": { "latitude": 40.0, "longitude": -75.0, "accuracy": 5 },
    "timestamp": "2026-06-22T00:00:00.000Z"
  }
}

Examples

cURL

curl --request POST 'https://api.firstdelivery.com/api/runners/location' \
  --header 'Content-Type: application/json' \
  --data '{
  "location": {
    "coords": { "latitude": 40.0, "longitude": -75.0, "accuracy": 5 },
    "timestamp": "2026-06-22T00:00:00.000Z"
  }
}'

Node.js

const response = await fetch("https://api.firstdelivery.com/api/runners/location", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": "{\n  \"location\": {\n    \"coords\": { \"latitude\": 40.0, \"longitude\": -75.0, \"accuracy\": 5 },\n    \"timestamp\": \"2026-06-22T00:00:00.000Z\"\n  }\n}"
})
const data = await response.json()

Python

import requests

response = requests.request(
    "POST",
    "https://api.firstdelivery.com/api/runners/location",
    headers={
  'Content-Type': 'application/json'
},
    data="{\n  \"location\": {\n    \"coords\": { \"latitude\": 40.0, \"longitude\": -75.0, \"accuracy\": 5 },\n    \"timestamp\": \"2026-06-22T00:00:00.000Z\"\n  }\n}",
)
response.raise_for_status()

Saved responses

200 200 OK

Location updated successfully