Skip to navigation
FTL TripsGuides

7. Transporter side

Answer offers, see your trips and assign your drivers

This page is for transporters: trucking companies that run trips for a Mile company. The company outsources trips to you, or offers them to you, from the Mile web app. You answer and assign your drivers through the API, with your own login and token, and only the /api/v1/partners/transporters endpoints.

The company can also outsource a trip to you directly, without an offer. It then appears in your trips, ready for a driver, and you skip steps 2 and 3.

1

Log in

Log in with the email or username and password you use on the Mile web app. See transporter login.

curl -X POST "https://lastmile.milenow.com/index.php/api/v1/partners/transporters/login" \
  -H "Content-Type: application/json" \
  -d '{"user": "dispatch@desertline.example", "password": "YOUR_PASSWORD"}'

Send data.access_token as Authorization: Bearer ... on every other call. It lasts 90 minutes.

2

Read your open offers

GET /api/v1/partners/transporters/offers lists the trips offered to you that wait for an answer, soonest to expire first.

curl "https://lastmile.milenow.com/index.php/api/v1/partners/transporters/offers" \
  -H "Authorization: Bearer $TRANSPORTER_TOKEN"
{
  "status": 200,
  "msg": "Offers fetched successfully",
  "msgs": [],
  "data": [
    {
      "offer_id": 42,
      "expires_at": "2026-10-28 16:45:22",
      "seconds_left": 7183,
      "trip": {
        "id": 413,
        "type": "outbound",
        "busy_from": "2026-11-03 09:30:00",
        "busy_to": "2026-11-03 13:40:00",
        "customer_details_hidden": true,
        "stops": [
          {
            "order_id": 70003943809,
            "leg": "outbound",
            "pickup": { "address": "Jiddah", "from": "2026-11-03 10:00:00", "to": "2026-11-03 11:00:00" },
            "delivery": { "address": "South Industrial Area, Jeddah", "from": "2026-11-03 12:00:00", "to": "2026-11-03 14:00:00" },
            "shipment": { "containers": [{ "container_no": "MSKU4821736", "size": "40ft", "weight": "26000" }] }
          }
        ]
      }
    }
  ]
}

You see the route, times and containers. Customer and consignee names and phones are hidden until you accept.

3

Accept or reject

Send the offer_id values, not the trip ids. You can answer several offers at once.

POST /api/v1/partners/transporters/offers/accept

curl -X POST "https://lastmile.milenow.com/index.php/api/v1/partners/transporters/offers/accept" \
  -H "Authorization: Bearer $TRANSPORTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "offer_ids": [42] }'
{
  "status": 200,
  "msg": "Accepted 1 trip. Please assign a driver.",
  "msgs": [],
  "data": { "accepted_trip_ids": [413], "failed": [] }
}

The trip is now outsourced to you.

If some offers fail, the call still returns 200 and lists them in failed. If all of them fail, it returns 409, for example Offer 42 (trip 413): Offer is no longer open.

failed[].reasonMeaning
Offer not foundNot an offer to you
Offer is no longer openAlready answered, withdrawn by the company, or moved on
Time to accept has run outexpires_at has passed
Trip was assigned to someone elseThe company gave the trip to a driver or another transporter
4

Assign your driver

List your drivers with GET /api/v1/partners/transporters/drivers, then call POST /api/v1/partners/transporters/trips/{tripId}/driver.

curl "https://lastmile.milenow.com/index.php/api/v1/partners/transporters/drivers" \
  -H "Authorization: Bearer $TRANSPORTER_TOKEN"
{
  "status": 200,
  "msg": "Drivers fetched successfully",
  "msgs": [],
  "data": [
    { "id": 7019258, "name": "Yusuf Ali", "phone": "+966500000000", "vehicle": { "id": 7012246, "name": "Desert Line Truck 1", "plate": "DLT 5123" } }
  ]
}
curl -X POST "https://lastmile.milenow.com/index.php/api/v1/partners/transporters/trips/413/driver" \
  -H "Authorization: Bearer $TRANSPORTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "driver_id": 7019258 }'

The response is the full trip with status 4 Dispatch, your driver, and a new ETA plan. Send another driver_id to change the driver until the trip starts.

Your trips

GET /api/v1/partners/transporters/trips lists trips outsourced to you and trips with an open offer to you, newest first. offer is set on trips you have not answered yet. It takes the same filters as the company list, except partner_id.

curl -G "https://lastmile.milenow.com/index.php/api/v1/partners/transporters/trips" \
  -H "Authorization: Bearer $TRANSPORTER_TOKEN" \
  --data-urlencode "page=1"

GET /api/v1/partners/transporters/trips/{tripId} returns one trip with stops and ETA plan. customer_details_hidden is true while the trip is only offered.

What you can see

Offered to youOutsourced to you
Stops, times, addresses, coordinatesYesYes
Containers and FTL numbersYesYes
Customer and consignee names and phonesNoYes
Names in the ETA planReplaced by addressesYes
Assign a driverNoYes, until the trip starts

Errors

ErrorCause
401 invalid accessMissing token, or a company token on a transporter endpoint
401 Your token expired.Log in again
403 Your partner account is disabledThe company disabled your account
404 Trip not foundThe trip is not outsourced or offered to you
409 ... is busy on Shipment Trip #...Your driver has an overlapping trip. Pick another driver
409 This trip has already started, the driver can no longer be changed.Status 5 or later
412 You can only assign your own drivers.The driver is not in your drivers list