List open offers | Mile Solutions

{
  "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",
        "status": null,
        "created_at": "2026-10-28 14:42:16",
        "outbound_stops": 1,
        "return_stops": 0,
        "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": {
              "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": {
                "address": "Al Sulaimaniyah Industrial, Jeddah",
                "latitude": null,
                "longitude": null
              },
              "consigner": {
                "address": "Al Sulaimaniyah Industrial, Jeddah",
                "latitude": null,
                "longitude": null
              },
              "consignee": {
                "address": "South Industrial Area, Jeddah",
                "latitude": null,
                "longitude": 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": "South Industrial Area, Jeddah",
                  "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": true
      }
    }
  ]
}

Transporter token. Trips offered to you that wait for your answer, soonest to expire first. You see stops, addresses, times and containers. Customer and consignee names and phones appear after you accept.

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.

Response

Success

statusinteger

msgstring

msgslist of strings

datalist of objects

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error