Get one of your trips | Mile Solutions

{
  "status": 200,
  "msg": "Shipment trip fetched successfully",
  "msgs": [],
  "data": {
    "id": 413,
    "type": "outbound",
    "status": null,
    "created_at": "2026-10-28 14:42:16",
    "outbound_stops": 1,
    "return_stops": 0,
    "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
            }
          ]
        }
      ]
    },
    "customer_details_hidden": false
  }
}

Transporter token. A trip outsourced or offered to you, with stops and ETA plan. While it is only offered, customer_details_hidden is true and customer names and phones are removed.

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.

Response

Success

statusinteger

msgstring

msgslist of strings

dataobject

Errors

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error