1. Shipments
  • Introduction
  • Getting Started
  • Authentication
  • Error Handling
  • Contact Support
  • Modaltrans API
    • Get Auth Token
      • Get Bearer Token
    • Accounting
      • Invoices
        • Retrieve an Invoice
        • List all Invoices
    • Customs
      • NCTS Declarations
        • List all NCTS Declarations
        • Retrieve an NCTS Declaration
        • Create an NCTS Declaration with XML Data
        • Create an Ens Declaration from JSON
        • Update an NCTS Declaration
        • Download an NCTS Declaration
        • List Timelines of NCTS Declaration
        • List Messages of NCTS Decalaration
      • Customs Declarations
        • List all Customs Declarations
        • Retrieve a Custom Declaration
        • Create a Customs Declaration
        • Update a Custom Declaration
        • Delete a Custom Declaration
        • Retrieve a Declaration History
        • Retrieve an MRN Status of Declaration
      • Declaration Requests
        • List all Declaration Orders
        • Retrieve a Declaration Request
        • Create a Declaration Request
        • Update a Declaration Request
        • Delete a Declaration Request
    • Logistics
      • Bookings
        • Retrieve a Booking
        • List all Bookings
        • Create a Booking
        • Update a Booking
      • Locations
        • List all Locations
        • Retrieve a Location
      • Positions
        • Update a Transport
      • Tracking
        • Available Shipping Lines
        • Retrieve a Tracking Data
        • Subscribe to Tracking
      • Shipments
        • Retrieve a Shipment
          GET
        • List All Shipments
          GET
        • Retrieve Financials of Shipment
          GET
        • List Contacts of the Shipment
          GET
        • Create a Shipment
          POST
        • Update a Shipment
          PATCH
    • Depot
      • Orders
        • Retrieve an Order
        • List all Orders
        • Create an Order
        • Update an Order
      • Products
        • Retrieve a Product
        • List all Products
        • Create a Product
        • Update a Product
        • List Product Stocks
      • Inventories
        • List all Inventories
    • Fleet Management
      • Drivers
        • Retrieve a Driver
        • Retrieve a Driver's Vehicle
        • List Driver Positions
        • Update a Driver
      • Vehicles
        • Retrieve a Vehicle
        • Update a Vehicle
      • Gps Service Controller
        • Create Gps Responses
      • Service Logs
        • List all Service Logs
        • Retrieve a Service Log
        • Create a Service Log
        • Delete a Service Log
        • Update a Service Log
      • Periodic Documents
        • Retrieve a Periodic Document
        • Update a Periodic Document
        • Create a Periodic Document
    • CRM
      • Companies
        • List all Companies
        • Retrieve a Company
        • Create a Company
        • Update a Company
        • Delete a Company
    • Timelines
      • Retrieve a Timeline
      • List Timelines
      • Create a Timeline
    • S3 Files
      • List all S3Files
      • Create an S3File
      • Delete an S3File
    • Notifications
      • List all Notifications
      • Update a Notification Status
    • User Details
      • List User Details
      • Update User Details
  1. Shipments

Update a Shipment

Developing
Testing Env
https://demo.modaltrans.com
Testing Env
https://demo.modaltrans.com
PATCH
/api/v1/shipments/{id}
Update a Shipment.
If you want to update booking part of shipment you should use Booking path with booking parameters.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
id
integer 
required
ID of the Shipment.
Example:
2130791
Body Params application/json
Shipment Part
status
enum<string> 
optional
Status of the shipment
Allowed values:
planningactivearrived
trans_method
enum<string> 
optional
Trans Method
Allowed values:
roadseaairrail
waybill_no
string 
optional
Waybill No or BOL/CMR No or Awb no
waybill_date
string <date>
optional
Waybill Date or BOL/CMR Date or Awb Date
truck_type
string 
optional
Type of truck
Examples:
trailertruckvan
estimated_dep_date
string <date-time>
optional
ETD
estimated_arv_date
string <date-time>
optional
ETA
arv_country_id
string 
optional
Arrival Country ID
Examples:
GBUSTR
dep_country_id
string 
optional
Departure Country ID
voyage
string 
optional
Voyage No
supplier_name
string 
optional
Supplier Company
truck_code
string 
optional
Truck No
vessel_code
string 
optional
Vessel Code or Trailer No
driver_name
string 
optional
Name of the driver
driver_tel
string 
optional
Tel number of the driver
driver_email
string <email>
optional
Email of the driver
deadline_date
string <date-time>
optional
Deadline Date
target_volume
number 
optional
Target Volume
target_weight
number 
optional
Targer Weight
hub_motion_exit_date
string <date-time>
optional
Trasnfer Hub Exit Date
contract_type
enum<string> 
optional
Owned or Rented
Allowed values:
ownedrented
empty_truck
boolean 
optional
Trailer Empty or not
freight_price
number 
optional
Freight Price
freight_curr
string 
optional
Freight Curr
Examples:
USDGBP
dep_odemeter
integer 
optional
Deoarture KM
arv_odemeter
integer 
optional
Arrival KM
total_fuel
number 
optional
Total Fuel
driver_payment
number 
optional
Driver Payment
waybill_type
string 
optional
Waybill Type
commission
number 
optional
Allowance
vagon
string 
optional
Wagon
vehicle_movement_type
string 
optional
Trailer Movement Type
intermodal
boolean 
optional
Intermodal
coagent_hbl_no
string 
optional
Co-Agent House No
border_date
string <date>
optional
Border Date / Cut-Off
assigned_date
string <date-time>
optional
Truck Assign Date
free_time
integer 
optional
Free Time
container_no
string 
optional
Container No
container_type
string 
optional
Container Type
cmr_no
string 
optional
CMR No
cargo_manifest_no
string 
optional
Cargo Manifest No
cargo_manifest_date
string <date>
optional
Cargo Manifest Date
transit_code1
string 
optional
1.
Voyage No
transit_code2
string 
optional
2.
Voyage No
transit_code3
string 
optional
3.
Voyage No
departure_date
string <date-time>
optional
Departure Date
arrival_date
string <date-time>
optional
Arrival Date
trans_type
string 
optional
Operation Type
active_date
string <date-time>
optional
OP: Active Date
freight_price_rate
number 
optional
Tariff Rate
ppcc
enum<string> 
optional
Payment Term
Allowed values:
ppcc
agent_name
string 
optional
Agent Name
route_notes
string 
optional
Route Notes
transit_date1
string <date>
optional
1.
Transfer Date
transit_date2
string <date>
optional
2.
Transfer Date
transit_date3
string <date>
optional
3.
Transfer Date
report_date
string <date>
optional
Report Date
Example
{
    "position": {

        "extref": "test12"
    }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://demo.modaltrans.com/api/v1/shipments/2130791' \
--header 'Content-Type: application/json' \
--data-raw '{
    "position": {

        "extref": "test12"
    }
}'

Responses

🟢200Success
application/json
Body
alert
string 
required
Example
{
    "alert": "Transport has been updated succesfully"
}
🟠403Forbidden
🟠404Record Not Found
🟠400Bad Request
Modified at 2025-03-21 23:57:59
Previous
Create a Shipment
Next
Retrieve an Order
Built with