1. NCTS Declarations
  • 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
          GET
        • Retrieve an NCTS Declaration
          GET
        • Create an NCTS Declaration with XML Data
          POST
        • Create an Ens Declaration from JSON
          POST
        • Update an NCTS Declaration
          PATCH
        • Download an NCTS Declaration
          GET
        • List Timelines of NCTS Declaration
          GET
        • List Messages of NCTS Decalaration
          GET
      • 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
        • 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. NCTS Declarations

List Timelines of NCTS Declaration

Testing Env
https://demo.modaltrans.com
Testing Env
https://demo.modaltrans.com
GET
/api/v1//ncts_declarations/{reference}{id}{mrn}{lrn}/timelines
Lists timelines of the NCTS Declaration using the parameters specified below.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
reference
string 
required
Reference number of the declaration.
id
integer 
required
ID of the declaration.
mrn
string 
required
MRN number of the declaration.
lrn
string 
required
LRN number of the declaration.

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//ncts_declarations//timelines'

Responses

🟢200OK
application/json
Body
transaction_id
integer 
required
Transaction ID of the NCTS Declaration
reference
string 
required
Reference number of the NCTS Declaration
doc_type
string 
required
Type of the document
doc_date
string <date>
required
Date of the document
transit_date
string <date>
required
Date of transit
status
string 
required
Status of the of the NCTS Declaration
lrn
string 
required
LRN of the NCTS Declaration
mrn
string 
required
MRN of the NCTS Declaration
manifesto_price
number 
required
Price of the NCTS Declaration
manifesto_curr
string 
required
Currency of the NCTS Declaration price
guarantee_price
number 
required
Price of the guarantee
guarantee_diff
number 
required
Guarantee addition
guarantee_curr
string 
required
Currency of the guarantee price
seal_no
string 
required
Seal No
lrn_date
string <date-time>
required
Date of the LRN
mrn_date
string <date-time>
required
Date of the MRN
manifesto_closed_date
string <date-time>
required
Timestamp of declaration closing
vahicle_arrived_date
string <date-time>
required
Timestamp of vehicle arriving
custom_staff_name
string  | null 
required
Name of the customs staff
custom_line
string 
required
Customs Line
timelines
array [object {6}] 
required
timeline_id
string 
optional
ID of activity
status_date
string <date-time>
optional
Timestamp of activity
status_code
string 
optional
Name of activity
notes
string 
optional
Notes of activity
source
string 
optional
Source of activty
country_id
string 
optional
Country ID of activty
Example
{
    "transaction_id": 0,
    "reference": "string",
    "doc_type": "string",
    "doc_date": "2019-08-24",
    "transit_date": "2019-08-24",
    "status": "string",
    "lrn": "string",
    "mrn": "string",
    "manifesto_price": 0,
    "manifesto_curr": "string",
    "guarantee_price": 0,
    "guarantee_diff": 0,
    "guarantee_curr": "string",
    "seal_no": "string",
    "lrn_date": "2019-08-24T14:15:22Z",
    "mrn_date": "2019-08-24T14:15:22Z",
    "manifesto_closed_date": "2019-08-24T14:15:22Z",
    "vahicle_arrived_date": "2019-08-24T14:15:22Z",
    "custom_staff_name": "string",
    "custom_line": "string",
    "timelines": [
        {
            "timeline_id": "string",
            "status_date": "2019-08-24T14:15:22Z",
            "status_code": "string",
            "notes": "string",
            "source": "string",
            "country_id": "string"
        }
    ]
}
🟠400Bad Request
🟠403Forbidden
🟠404Record Not Found
Modified at 2025-03-25 10:48:33
Previous
Download an NCTS Declaration
Next
List Messages of NCTS Decalaration
Built with