1. Tracking
  • 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
          GET
        • Subscribe to Tracking
          POST
      • 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. Tracking

Retrieve a Tracking Data

Developing
Testing Env
https://demo.modaltrans.com
Testing Env
https://demo.modaltrans.com
GET
/api/v1/trackings/{tracking_number}
Retrieves a Tracking Data of the Loading.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
tracking_number
string 
required
The container number or Bill of Lading number of loading.
Example:
MEDUAA12345
Query Params
tracking_by
enum<string> 
required
Specifies whether to tracked by Container (CT) number or Bill of Lading (BL) number.
Allowed values:
BLCT
Example:
BL

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/trackings/MEDUAA12345?tracking_by=BL'

Responses

🟢200OK
application/json
Body
carrier_code
string 
required
Standard Carrier Alpha Code (SCAC)
etd
string  | null 
required
ETD
atd
string  | null 
required
ATD
eta
string  | null 
required
ETA
ata
string  | null 
required
ATA
lat
number 
required
Latitude
lng
number 
required
Longitude
last_ship_name
string 
required
Last Ship Name
last_ship_imo
string 
required
Last Ship IMO
last_ship_voyage
string  | null 
required
Last Ship Voyage
tracking_containers
array [object {7}] 
required
container_no
string 
required
Container NO
last_vessel_name
string 
required
Last Vessel Name
last_vessel_imo
string 
required
Last Vessel IMO
last_voyage_ref
string  | null 
required
Last Voyage Ref
last_location_code
string  | null 
required
Last Location Code
last_location_name
string 
required
Last Location Name
tracking_events
array [object {10}] 
required
Example
{
    "carrier_code": "string",
    "etd": "string",
    "atd": "string",
    "eta": "string",
    "ata": "string",
    "lat": 0,
    "lng": 0,
    "last_ship_name": "string",
    "last_ship_imo": "string",
    "last_ship_voyage": "string",
    "tracking_containers": [
        {
            "container_no": "string",
            "last_vessel_name": "string",
            "last_vessel_imo": "string",
            "last_voyage_ref": "string",
            "last_location_code": "string",
            "last_location_name": "string",
            "tracking_events": [
                {
                    "event_desc": "string",
                    "event_date": "2019-08-24T14:15:22Z",
                    "system_status": "string",
                    "location_code": "string",
                    "location_name": "string",
                    "terminal_name": "string",
                    "voyage_ref": "string",
                    "vessel_name": "string",
                    "vessel_imo": "string",
                    "estimated": true
                }
            ]
        }
    ]
}
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
Modified at 2024-12-23 11:24:23
Previous
Available Shipping Lines
Next
Subscribe to Tracking
Built with