Create an FTL | Mile Solutions

curl -X POST https://lastmile.milenow.com/index.php/api/v1/partners/shipments \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "shipment_no": "SHP-1001",
  "bl_no": "BL-55001",
  "created_on": "2026-11-03",
  "expected_on": "2026-11-03",
  "shipping_line": "MAERSK",
  "payment_term": "Company Credit",
  "shipping_charges": 2200,
  "other_charges": 150,
  "customer": {
    "name": "Coastal Trading LLC",
    "phone": "+966500000000",
    "address": "Al Sulaimaniyah Industrial, Jeddah"
  },
  "consignee": {
    "name": "Coastal Trading Factory",
    "address": "South Industrial Area, Jeddah"
  },
  "containers": [
    {
      "container_no": "MSKU4821736",
      "seal_no": "SL-77120",
      "size": "40ft",
      "quantity": 1,
      "weight": 26000,
      "category": "Containers",
      "product": "40ft GP Container - Full"
    }
  ],
  "pickup_from_port": true,
  "destination_port": "SA JED",
  "vessel": "MAERSK SELETAR",
  "voyage_no": "442W"
}'

{
  "status": 200,
  "msg": "Shipment created",
  "msgs": [],
  "data": {
    "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"
        }
      }
    ]
  }
}

Company token. Creates one FTL. Put it on a trip in the Mile web app, or add it to an existing trip with add stops and its shipment_id. You can also create an FTL inside a stop when you add stops. Every problem is returned at once in msgs. See create FTLs.

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.

Request

This endpoint expects an object.

shipment_nostringRequired

Your FTL number.

bl_nostringRequired

Bill of lading number.

created_ondateRequired

Pickup day, Y-m-d.

expected_ondateRequired

Delivery day, Y-m-d. Same day as created_on or later.

shipping_linestringRequired

Name from options. Or send shipping_line_id.

payment_termstringRequired

Name from options. Or send payment_term_id.

shipping_chargesdoubleRequired>=0

0 or more.

other_chargesdoubleRequired>=0

0 or more.

customerobjectRequired

A customer (shipper) or consignee (receiver). Send id for an existing one, or name and address (plus phone for a customer) for a new one. See customers and consignees.

consigneeobjectRequired

A customer (shipper) or consignee (receiver). Send id for an existing one, or name and address (plus phone for a customer) for a new one. See customers and consignees.

containerslist of objectsRequired

At least one container.

shipping_line_idintegerOptional

payment_term_idintegerOptional

pickup_from_portbooleanOptional

true to pick the container up at destination_port instead of the customer address. Requires destination_port.

destination_portstringOptional

Port name, code or UN/LOCODE from ports. Or send destination_port_id.

destination_port_idintegerOptional

origination_portstringOptional

Optional. Name, code or UN/LOCODE. Or origination_port_id.

origination_port_idintegerOptional

stayed_portslist of stringsOptional

Optional transit ports, as names, codes, UN/LOCODEs or ids.

vendorstringOptional

Required only when options returns vendor_required: true. Or vendor_id.

vendor_idintegerOptional

vendor_categorystringOptional

Optional. Or vendor_category_id.

vendor_category_idintegerOptional

shipping_methodstringOptional

Optional. Or shipping_method_id.

shipping_method_idintegerOptional

countrystringOptional

Optional country name or short name. Or country_id.

country_idintegerOptional

tracking_nostringOptional

Optional. Generated when empty. Must be unique.

documentslist of objectsOptional

vesselstringOptional

voyage_nostringOptional

notesstringOptional

declared_valuestringOptional

insurance_valuestringOptional

shippers_referencestringOptional

consignment_referencestringOptional

pre_carriage_bystringOptional

Response

Success

statusinteger

msgstring

msgslist of strings

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

409

Conflict Error

412

Precondition Failed Error

429

Too Many Requests Error