Assign your driver

POST

https://lastmile.milenow.com/index.php/api/v1/partners/shipment-trips/:tripId/driver

POST

/index.php/api/v1/partners/shipment-trips/:tripId/driver

curl -X POST https://lastmile.milenow.com/index.php/api/v1/partners/shipment-trips/412/driver \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "driver_id": 7009107
}'

{
  "status": 200,
  "msg": "Driver assigned",
  "msgs": [],
  "data": {
    "id": 412,
    "type": "round_trip",
    "status": {
      "id": 4,
      "name": "Dispatch"
    },
    "created_at": "2026-10-28 14:42:16",
    "outbound_stops": 1,
    "return_stops": 1,
    "driver": {
      "id": 7009107,
      "name": "Omar Khalid",
      "phone": "+966500000000",
      "vehicle": {
        "id": 7002187,
        "name": "Flatbed 1",
        "plate": "ABC 1234"
      }
    },
    "partner": null,
    "busy_from": "2026-11-03 09:30:00",
    "busy_to": "2026-11-03 17:41:00",
    "stops": [
      {
        "order_id": 70003943807,
        "tracking_no": "MSKU4821736",
        "leg": "outbound",
        "stop_no": 1,
        "pickup_sequence": 1,
        "delivery_sequence": 2,
        "status": {
          "id": 1,
          "name": "Scheduled"
        },
        "pickup": {
          "address": "Jiddah",
          "latitude": null,
          "longitude": null,
          "from": "2026-11-03 10:00:00",
          "to": "2026-11-03 11:00:00"
        },
        "delivery": {
          "name": "Coastal Trading Factory",
          "phone": "",
          "address": "South Industrial Area, Jeddah",
          "latitude": null,
          "longitude": null,
          "from": "2026-11-03 12:00:00",
          "to": "2026-11-03 14:00:00"
        },
        "staging_warehouse": null,
        "eta": "2026-11-03 12:09:00",
        "shipment": {
          "id": 301,
          "shipment_no": "SHP-1001",
          "tracking_no": "TRK48210",
          "bl_no": "BL-55001",
          "vessel": "MAERSK SELETAR",
          "voyage_no": "442W",
          "shipping_line": {
            "id": 10,
            "name": "MAERSK"
          },
          "status": {
            "id": 23,
            "name": "Local Dispatch"
          },
          "created_on": "2026-11-03 00:00:00",
          "expected_on": "2026-11-03 00:00:00",
          "merchant": {
            "id": 13618,
            "short_name": "Coastal Trading LLC",
            "long_name": "Coastal Trading LLC",
            "address": "Al Sulaimaniyah Industrial, Jeddah",
            "latitude": null,
            "longitude": null
          },
          "consigner": {
            "id": 7001021045,
            "name": "Coastal Trading LLC",
            "address": "Al Sulaimaniyah Industrial, Jeddah",
            "latitude": null,
            "longitude": null,
            "contact_person_name": "Coastal Trading LLC",
            "contact_person_contact": "+966500000000",
            "contact_person_email": null
          },
          "consignee": {
            "id": 7001021046,
            "name": "Coastal Trading Factory",
            "address": "South Industrial Area, Jeddah",
            "latitude": null,
            "longitude": null,
            "contact_person_name": "Coastal Trading Factory",
            "contact_person_contact": "",
            "contact_person_email": null
          },
          "pickup_from_port": true,
          "destination_port": {
            "id": 61021,
            "name": "Jiddah",
            "unlocode": "SA JED",
            "latitude": null,
            "longitude": null
          },
          "warehouse": null,
          "is_direct_delivery": true,
          "containers": [
            {
              "id": 376,
              "container_no": "MSKU4821736",
              "seal_no": "SL-77120",
              "size": "40ft",
              "weight": "26000",
              "quantity": 1,
              "category": {
                "id": 702810,
                "name": "Containers"
              },
              "product": {
                "id": 875777,
                "name": "40ft GP Container - Full"
              }
            }
          ]
        }
      },
      {
        "order_id": 70003943808,
        "tracking_no": "MSKU4821736-2",
        "leg": "return",
        "stop_no": 1,
        "pickup_sequence": 3,
        "delivery_sequence": 4,
        "status": {
          "id": 1,
          "name": "Scheduled"
        },
        "pickup": {
          "address": "South Industrial Area, Jeddah",
          "latitude": null,
          "longitude": null,
          "from": "2026-11-03 15:00:00",
          "to": "2026-11-03 16:00:00"
        },
        "delivery": {
          "name": "Jeddah Port Empty Depot",
          "phone": "",
          "address": "Jeddah Islamic Port, Jeddah",
          "latitude": null,
          "longitude": null,
          "from": "2026-11-03 16:30:00",
          "to": "2026-11-03 18:00:00"
        },
        "staging_warehouse": null,
        "eta": "2026-11-03 16:28:00",
        "shipment": {
          "id": 302,
          "shipment_no": "SHP-1002",
          "tracking_no": "TRK48211",
          "bl_no": "BL-55002",
          "vessel": "",
          "voyage_no": "",
          "shipping_line": {
            "id": 10,
            "name": "MAERSK"
          },
          "status": {
            "id": 23,
            "name": "Local Dispatch"
          },
          "created_on": "2026-11-03 00:00:00",
          "expected_on": "2026-11-03 00:00:00",
          "merchant": {
            "id": 13618,
            "short_name": "Coastal Trading LLC",
            "long_name": "Coastal Trading LLC",
            "address": "Al Sulaimaniyah Industrial, Jeddah",
            "latitude": null,
            "longitude": null
          },
          "consigner": {
            "id": 7001021046,
            "name": "Coastal Trading Factory",
            "address": "South Industrial Area, Jeddah",
            "latitude": null,
            "longitude": null,
            "contact_person_name": "Coastal Trading Factory",
            "contact_person_contact": "",
            "contact_person_email": null
          },
          "consignee": {
            "id": 7001021047,
            "name": "Jeddah Port Empty Depot",
            "address": "Jeddah Islamic Port, Jeddah",
            "latitude": null,
            "longitude": null,
            "contact_person_name": "Jeddah Port Empty Depot",
            "contact_person_contact": "",
            "contact_person_email": null
          },
          "pickup_from_port": false,
          "destination_port": null,
          "warehouse": null,
          "is_direct_delivery": true,
          "containers": [
            {
              "id": 377,
              "container_no": "MSKU4821736",
              "seal_no": "SL-77121",
              "size": "40ft",
              "weight": "3800",
              "quantity": 1,
              "category": {
                "id": 702810,
                "name": "Containers"
              },
              "product": {
                "id": 875789,
                "name": "40ft Container - Empty"
              }
            }
          ]
        }
      }
    ],
    "eta": {
      "calculated_at": "2026-10-28 14:42:16",
      "busy_from": "2026-11-03 09:30:00",
      "busy_to": "2026-11-03 17:41:00",
      "total_km": 80,
      "total_drive_min": 78,
      "late": false,
      "days": [
        {
          "date": "2026-11-03",
          "busy_from": "2026-11-03 09:30:00",
          "busy_to": "2026-11-03 17:41:00",
          "km": 80,
          "drive_min": 78,
          "late": false,
          "stops": [
            {
              "action": "Start",
              "kind": "base",
              "order_id": null,
              "shipment_no": null,
              "name": "Head office",
              "address": "Jeddah, Saudi Arabia",
              "arrive": null,
              "depart": "2026-11-03 09:30:00",
              "window_from": null,
              "window_to": null,
              "late": false
            },
            {
              "action": "Pickup",
              "kind": "pickup",
              "order_id": 70003943807,
              "shipment_no": "SHP-1001",
              "name": "Jiddah",
              "address": "Jiddah",
              "arrive": "2026-11-03 10:00:00",
              "depart": "2026-11-03 10:41:00",
              "window_from": "2026-11-03 10:00:00",
              "window_to": "2026-11-03 11:00:00",
              "late": false
            },
            {
              "action": "Deliver",
              "kind": "delivery",
              "order_id": 70003943807,
              "shipment_no": "SHP-1001",
              "name": "Coastal Trading Factory",
              "address": "South Industrial Area, Jeddah",
              "arrive": "2026-11-03 12:09:00",
              "depart": "2026-11-03 13:09:00",
              "window_from": "2026-11-03 12:00:00",
              "window_to": "2026-11-03 14:00:00",
              "late": false
            },
            {
              "action": "Pickup",
              "kind": "pickup",
              "order_id": 70003943808,
              "shipment_no": "SHP-1002",
              "name": "South Industrial Area, Jeddah",
              "address": "South Industrial Area, Jeddah",
              "arrive": "2026-11-03 15:00:00",
              "depart": "2026-11-03 16:00:00",
              "window_from": "2026-11-03 15:00:00",
              "window_to": "2026-11-03 16:00:00",
              "late": false
            },
            {
              "action": "Deliver",
              "kind": "delivery",
              "order_id": 70003943808,
              "shipment_no": "SHP-1002",
              "name": "Jeddah Port Empty Depot",
              "address": "Jeddah Islamic Port, Jeddah",
              "arrive": "2026-11-03 16:28:00",
              "depart": "2026-11-03 17:28:00",
              "window_from": "2026-11-03 16:30:00",
              "window_to": "2026-11-03 18:00:00",
              "late": false
            },
            {
              "action": "Back at base",
              "kind": "return",
              "order_id": null,
              "shipment_no": null,
              "name": "Head office",
              "address": "Jeddah, Saudi Arabia",
              "arrive": "2026-11-03 17:41:00",
              "depart": "2026-11-03 17:41:00",
              "window_from": null,
              "window_to": null,
              "late": false
            }
          ]
        }
      ]
    },
    "warnings": []
  }
}

Company token. Assigns one of your own drivers to a trip that is not outsourced and has not started. The trip status becomes 4 Dispatch, the FTLs are dispatched to the driver and the trip is optimized again. Send another driver_id to change the driver. See assign your driver.

Authentication

AuthorizationBearer

Send Authorization: Bearer <token>. Company endpoints take the company API token from POST /api/v1/partners/login. /transporters endpoints take the transporter token from POST /api/v1/partners/transporters/login. You can also send the token as an access_token query parameter or body field.

Path parameters

tripIdintegerRequired

Trip id.

Request

This endpoint expects an object.

driver_idintegerRequired

A driver from GET /api/v1/partners/drivers that does not belong to a transporter.

Response

Success

statusinteger

msgstring

msgslist of strings

dataobject

Errors

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

412

Precondition Failed Error

429

Too Many Requests Error