Get current run

GET {{baseUrl}}/runs/{{userId}}

Returns the driver’s current batched run. Source: models/runs.ts getRunForRunner() — RunComposite type.

Response fields:

• batch — ordered list of pickup/drop stops (order_id, index, type: "pickup"|"drop", completed, data).

• batch[].data — stop details: vendor/customer (name/address/phone), instructions, lat/lng, order_number.

• acknowledged — timestamp the driver last acknowledged a run change.

• deferred_optimize_queued — true if the fast interactive route sort hit its scoring budget and a full re-optimize is queued in the background.

Examples

cURL

curl --request GET 'https://api.firstdelivery.com/api/runs/REPLACE_WITH_USER_ID'

Node.js

const response = await fetch("https://api.firstdelivery.com/api/runs/REPLACE_WITH_USER_ID", {
  "method": "GET",
  "headers": {}
})
const data = await response.json()

Python

import requests

response = requests.request(
    "GET",
    "https://api.firstdelivery.com/api/runs/REPLACE_WITH_USER_ID",
    headers={},
)
response.raise_for_status()

Saved responses

200 200 OK

{
  "runner_id": "8e17d5db-da6e-453c-966f-bfc72c125094",
  "acknowledged": "2026-06-22T14:00:00.000Z",
  "batch": [
    {
      "order_id": "REPLACE_WITH_ORDER_ID",
      "runner_id": "8e17d5db-da6e-453c-966f-bfc72c125094",
      "index": 0,
      "type": "pickup",
      "completed": false,
      "data": {
        "type": "pickup",
        "order_number": 4821,
        "vendor": {
          "name": "Tony's Pizza",
          "address": "123 Main St",
          "phone": "5551112222"
        },
        "customer": {
          "name": "Sam Customer",
          "address": "456 Oak Ave",
          "suite": "",
          "phone": "5557654321"
        },
        "instructions": "Leave at door",
        "lat": 39.95,
        "lng": -75.16
      }
    }
  ],
  "deferred_optimize_queued": false
}