How do I begin tracking shipments?

Here you will find information on what input is required to begin tracking a shipment. Vizion will refer to this as creating a new reference. Creating a new reference can be done in three ways.

Carrier Code

Tracking by carrier code will generate a single reference and return the most recent trip for the container. The API requires two inputs when tracking by container number:

1. Container tracking ID
2. Carrier code

{
   "container_id": "MRKU0090522",
   "carrier_code": "MAEU",
   "callback_url": "https://yourdomain.com/webhook"
}

Once the required input is passed a reference ID assigned to the container shipment will be included in the response. You may use the reference ID to get updates, reference status, unsubscribe, and more.

Bill of Lading

Tracking by bill of lading generates a reference for all containers related to the bill of lading, see more information on this in Create a reference via Bill of Lading overview. The API requires two inputs when tracking by master bill of lading:

1. Master bill of lading number
2. Carrier code

{
   "bill_of_lading": "MAEU255221188",
   "carrier_code": "MAEU",
   "callback_url": "https://yourdomain.com/webhook"
}

Once the required input is passed a reference ID assigned to the bill of lading will be included in the response. You may use the reference ID to get updates, reference status, unsubscribe, and more.

The reference ID assigned to the bill of lading will now act as a parent reference ID for all containers associated with the bill of lading. See more information on the parent/child relationship between bill of lading and container references here.

Auto Carrier Identification

Tracking by ACI will generate a single reference and return the most recent trip for the container. The API requires only the container ID:

1. Container tracking ID

{
  "container_id": "MRKU0090522",
  "callback_url": "https://yourdomain.com/webhook"
}

If a carrier is found we will add the carrier code value to your shipment and begin tracking it just as if you had provided the carrier code upon input. Please note that tracking by ACI should only be used if you do not know the carrier code. It is designed to be used as a discovery tool if the carrier is unknown and there is no other way to find the carrier. If the Auto Carrier Identification tool is used by default, you may expect a large number of tracking failures.