IBC. Inc.

IBC Track History Request API

Use this API to retrieve your status events associated with your IBC account in single track mode. This API will respond to your queries as a JSON object.

The Service URL is:
  

It is highly recommended to use the following parameter with your queries:
  • account - format "####" recommended, use your IBC 4 digit account number.
 ?account=#### 

We recommended to use 1 connection per attempt and cover a specific track number. If you need to regularly check the status of multiple track numbers, please use the Batch Tracking API instead.

Expected ouput

JSON Output - default

            
{
	host: "",
	message: "OK",
	result: [
	{
		key: 0,  						/* when available */
		aams_key: 0,  					/* when available */
		service: "XX",  				/* not available on AAMS entries */
		ibc_track: "",
		vendor_track: "",  				/* not available on AAMS entries */
		status: "Not available yet",  	/* not available on AAMS entries */
		port: "XXX",
		account: "####",
		events: [       /* when available */
			{   		
				event_code: "A",
				event_timestamp: "2023-04-18 23:54",
				event_location: "LAX",
				event_description: "GATEWAYED"
			}
		],
		aams_events: [  /* when available */
			{
				event_code: "A",
				event_timestamp: "2023-04-18 23:54",
				event_location: "LAX",
				event_description: "GATEWAYED"
			}
		],
		aams_port: "",       /* when available */ 
		aams_clearance: "",  /* when available */
		aams_status: "",     /* when available */
		pactrak_route: "LAX -> SSS", 	/* not available on AAMS entries */ 
		movement_time: "# days.",       	/* not available on AAMS entries */
		service_provider: "SSS",  			/* code of last mile provider */
		locate: ">SSS::40% ",        	/* not available on AAMS entries */
		total_weight: 0, 					/* not available on AAMS entries */
		total_value: 0,  					/* not available on AAMS entries */
		total_pieces: 0, 					/* not available on AAMS entries */
		description: "",  					/* not available on AAMS entries */
		shipper_name: "", 					/* not available on AAMS entries */
		consignee_name: "", 				/* not available on AAMS entries */
		consignee_destination: "",  		/* not available on AAMS entries */
		vendor_events: [  /* last mile provider events */
			{
				event_code: "XX",
				event_timestamp: "2024-04-19 18:52 UTC",
				event_location: "HOUSTON, TX-US",
				event_description: ""
			},

		],
		vendor_events_description: "OK-retrieved from last mile provider",
		piece_details: [  					/* when available */ 
			{
				piece_id: 0,
				track_number: "",
				billable_weight: "",
				reported_weight: "",
				dimensions: "#X  #X  #",
				dimmensions_unit: "IN",
				dimmensions_factor: "139"
			}
		]

	}],
	developer_message: "Request completed",
	code: 200,
	is_error: false,
	exec_tine: "GET: 566.190771ms "
}
            
            

Troubleshooting Recommendations

  • Test your URL call on a browser or Postman
  • If errors, please email IBC IT Team with a sample response and your URL

Event Codes

AAMS - Typical events (may not apply to every case)
CodeDescription
_AData Received
CCCleared Customs
GRGateway Received
_PDelivered to Last Mile Provider
PACTRAK - Normal Events (may not apply to every case)
CodeDescription
_AGatewayed at Station
_BBagged at Station
_MPrepared for Outbound
OFOut for Delivery
_PDelivered

For a full list of IBC events download this resource.

Resources

Station to Time Zone Reference

StationLocationTime ZoneGmt OffsetDaylight
LAXLos Angeles CA, USPST-8-7
DFWDallas TX, USCST-6-5
ORDChicago IL, USCST-6-5
NYCNew York NY, USEST-5-4
MIAMiami FL, USEST-5-4
Daylight Savings Time Change

Local times change at 2:00 a.m. EST to 3:00 a.m. EDT on the second Sunday in March, and return from 2:00 a.m. EDT to 1:00 a.m. EST on the first Sunday in November