1. Bookings
  • 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
          GET
        • List all Bookings
          GET
        • Create a Booking
          POST
        • Update a Booking
          PATCH
      • 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
        • List All Shipments
        • Retrieve Financials of Shipment
        • List Contacts of the Shipment
        • Create a Shipment
        • Update a Shipment
    • 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. Bookings

Retrieve a Booking

Developing
Testing Env
https://demo.modaltrans.com
Testing Env
https://demo.modaltrans.com
GET
/api/v1/bookings/{transaction_id}
Retrieves the details of a booking by its transaction ID.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
transaction_id
integer 
required
Transaction ID of booking.

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 GET 'https://demo.modaltrans.com/api/v1/bookings/'

Responses

🟢200OK
application/json
Body
array of:
transaction_id
integer 
required
ID of the transaction
uuid
string 
required
UUID of the booking
reference
string 
required
Reference number of the booking
branch_id
integer 
required
ID of the branch
company_uuid
string 
required
UUID of the company
company_name
string 
required
Name of the company
customer_ref
string 
required
Customer Reference
agent_ref
string 
required
Agency Reference
consignee_name
string 
required
Name of the consignee company
sender_name
string 
required
Name of the sender company
load_place_id
integer 
required
Origin place id
load_city
string 
required
Origin City
load_zipcode
string 
required
Zip code of the origin address
load_coun
string 
required
Origin country
load_place
string 
required
Origin address
load_date
string <date-time>
required
ETD
unload_place_id
integer 
required
ID of destination
unload_city
string 
required
Destination City
unload_zipcode
string 
required
Zip code of the destination address
unload_coun
string 
required
Destination Country
unload_place
string 
required
Destination place address
unload_date
string 
required
ETA
brut_wg
number 
required
Gross weight
volume
number 
required
Volume of the shipment
ladameter
number 
required
Ladameter
status
string 
required
Current status of the transaction
commodity
string 
required
Type of commodity being transported
category
string 
required
Category
group_id
integer 
required
ID of the group
price_wg
number 
required
Chargeable weight
teu
integer 
required
Twenty-foot Equivalent Unit
saler_name
string 
required
Name of the salesperson
saler_email
string 
required
Email of the salesperson
saler_office_tel
string 
required
Office telephone number of the salesperson
total_pack
number 
required
Total number of packages
carrier_name
string 
required
Carrier/Liner Name of the booking
waybill_no
string 
required
MBL No / MAWB No / CIM No /Transit Doc. No
customs_entry_duty_amount
number 
required
Custums Duty Amount
customs_entry_vat_amount
number 
required
Vat Amount
customs_entry_mrn
array[string]
required
MRN Numbers related to the booking
container_nos
array [object {2}] 
required
Container Numbers of the booking
size
string 
required
Size of the container
container_no
string 
required
Container No
free_time
integer 
required
Free Time
notify1
string 
required
Notified Company Name
notify2
string 
required
Notified Company Name 2
mbl_type
string 
required
Waybill Type
eta
string 
required
Estimated Arrival Time of the Shipment
etd
string 
required
Estimated DepartureTime of the Shipment
operator_name
string 
required
Operator Name
agent_name
string 
required
Agent Name
ship
array [object {2}] 
required
Ship Information
name
string 
required
Name of the Ship
imo_no
string 
required
Imo Number of the Ship
timelines
array [object {26}] 
required
Timelines related to the transaction
id
integer 
required
ID of the timeline
parent_type
string 
required
Type of parent entity
parent_id
integer 
required
ID of the parent entity
status_date
string <date-time>
required
Date of the status update
status_code
string 
required
Code representing the status
place_id
integer 
required
ID of the place
city_id
integer 
required
ID of the city
country_id
string 
required
ID of the country
notes
string 
required
Additional notes
source
string 
required
Source of the status update
group_id
integer 
required
ID of the group
user_id
integer 
required
ID of the user
patron_id
integer 
required
ID of the patron
customer_inform_type
boolean 
required
Indicates if the customer was informed
customer_inform_status
string 
required
Status of informing the customer
created_at
string <date-time>
required
Timestamp of creation
updated_at
string <date-time>
required
Timestamp of last update
lng
number 
required
Longitude coordinate
lat
number 
required
Latitude coordinate
place_name
string 
required
Name of the place
notify_senders
boolean 
required
Indicates if senders were notified
notify_consignees
boolean 
required
Indicates if consignees were notified
notify_companies
boolean 
required
Indicates if companies were notified
tenant_id
integer 
required
ID of the tenant
icon_code
string 
required
Fontawsome code
system_location
string 
required
System location
Example
[
    {
        "transaction_id": 0,
        "uuid": "string",
        "reference": "string",
        "branch_id": 0,
        "company_uuid": "string",
        "company_name": "string",
        "customer_ref": "string",
        "agent_ref": "string",
        "consignee_name": "string",
        "sender_name": "string",
        "load_place_id": 0,
        "load_city": "string",
        "load_zipcode": "string",
        "load_coun": "string",
        "load_place": "string",
        "load_date": "2019-08-24T14:15:22Z",
        "unload_place_id": 0,
        "unload_city": "string",
        "unload_zipcode": "string",
        "unload_coun": "string",
        "unload_place": "string",
        "unload_date": "string",
        "brut_wg": 0,
        "volume": 0,
        "ladameter": 0,
        "status": "string",
        "commodity": "string",
        "category": "string",
        "group_id": 0,
        "price_wg": 0,
        "teu": 0,
        "saler_name": "string",
        "saler_email": "string",
        "saler_office_tel": "string",
        "total_pack": 0,
        "carrier_name": "string",
        "waybill_no": "string",
        "customs_entry_duty_amount": 0,
        "customs_entry_vat_amount": 0,
        "customs_entry_mrn": [
            "string"
        ],
        "container_nos": [
            {
                "size": "string",
                "container_no": "string"
            }
        ],
        "free_time": 0,
        "notify1": "string",
        "notify2": "string",
        "mbl_type": "string",
        "eta": "string",
        "etd": "string",
        "operator_name": "string",
        "agent_name": "string",
        "ship": [
            {
                "name": "string",
                "imo_no": "string"
            }
        ],
        "timelines": [
            {
                "id": 0,
                "parent_type": "string",
                "parent_id": 0,
                "status_date": "2019-08-24T14:15:22Z",
                "status_code": "string",
                "place_id": 0,
                "city_id": 0,
                "country_id": "string",
                "notes": "string",
                "source": "string",
                "group_id": 0,
                "user_id": 0,
                "patron_id": 0,
                "customer_inform_type": true,
                "customer_inform_status": "string",
                "created_at": "2019-08-24T14:15:22Z",
                "updated_at": "2019-08-24T14:15:22Z",
                "lng": 0,
                "lat": 0,
                "place_name": "string",
                "notify_senders": true,
                "notify_consignees": true,
                "notify_companies": true,
                "tenant_id": 0,
                "icon_code": "string",
                "system_location": "string"
            }
        ]
    }
]
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
Modified at 2025-04-16 09:39:06
Previous
Delete a Declaration Request
Next
List all Bookings
Built with