Assign your driver to a trip | Mile Solutions

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

{
  "status": 200,
  "msg": "Driver assigned",
  "msgs": [],
  "data": {
    "id": 413,
    "type": "outbound",
    "status": {
      "id": 4,
      "name": "Dispatch"
    },
    "created_at": "2026-10-28 14:42:16",
    "outbound_stops": 1,
    "return_stops": 0,
    "driver": {
      "id": 7019258,
      "name": "Yusuf Ali",
      "phone": "+966500000000",
      "vehicle": {
        "id": 7012246,
        "name": "Desert Line Truck 1",
        "plate": "DLT 5123"
      }
    },
    "partner": {
      "id": 7019257,
      "name": "Desert Line Transport"
    },
    "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": 10,
            "name": "Awaiting Approval"
          },
          "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"
              }
            }
          ]
        }
      }
    ],
    "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": "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": []
  }
}

Transporter token. Assigns one of your drivers to a trip outsourced to you, before it starts. You can change the driver the same way until the trip starts. The trip status becomes 4 Dispatch and the ETAs are recalculated.

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 list your drivers.

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