Print
Shipment Status Web Service - V2
A. Duie Pyle provides expanded shipment tracking information via a web service that returns either a JSON object or an XML document. We have multiple types of reference numbers you can utilize to track the shipments. You can use these by adjusting the type in the URL and providing the proper reference as the value.
This expanded shipment tracking (V2) web service returns more information than the previous shipment tracking (V1) web service.
Shipment Status Web Service - V1 documentation
Type 0 – Pyle Pro number
Using the Pyle Pro number is the quickest way to obtain the shipment status information.
https://api.aduiepyle.com/2/shipment/status?user=email-address
&type=0
&value=pro-number
Type 1 – Bill of Lading number
Both the Shipper assigned Bill of Lading number and the origination postal code are required.
https://api.aduiepyle.com/2/shipment/status?user=email-address
&type=1
&value=bill-of-lading-number
&zip=origination-zip
Type 2 – Partner Pro number
Shipments that are handled by both Pyle and one of our partners may be tracked using the partner's SCAC code and their pro number.
- DAFG = Dayton Freight Lines
- OAKH = Oak Harbor Freight Lines
- SEFL = Southeastern Freight Lines
- SZTG = Speedy Transport
https://api.aduiepyle.com/2/shipment/status?user=email-address
&type=2
&value=partner-pro-number
&partner=SCAC-code
Type 4 – Purchase Order number
Both the Consignee assigned Purchase Order number and the destination postal code are required.
Warning: Using the Purchase Order number is the slowest way to obtain shipment status information. Using the Pyle Pro number is the preferred way to track shipments. Using the Purchase Order number may result in timeouts.
https://api.aduiepyle.com/2/shipment/status?user=email-address
&type=4
&value=purchase-order-number
&zip=destination-zip
Status
The possible list of statuses is as follows.
- SCHEDULED
- The pro is scheduled on a delivery manifest to get delivered. The delivery truck has not yet left our terminal. The comment will usually give more information on this status.
- UNSCHEDULED
- The freight has not yet been assigned to a delivery manifest and is most likely on our dock somewhere.
- DELIVERED
- Pyle has delivered the pro to the consignee location.
- ATTEMPTED DELIVERY
- Pyle attempted delivery but was unable to complete it. (Delivery refused/location closed/after-hours/etc). Pro will most likely be brought back to try again.
- IN TRANSIT
- Shipment is in transit to a third party carrier.
- OUT FOR DELIVERY
- Shipment is on a delivery manifest that is currently out for delivery. Status will have more info. It will say what stop it is to be delivered on and what the last stop completed was/enroute to stop #.
- PICKED UP
- Pyle has already been to the shipper location and has picked up the freight. It has not been billed yet so it could still be on a truck returning to our terminal.
- NO FREIGHT
- Pyle went to pick up the shipment but there was no freight.
Status History Descriptions
A partial list of status history descriptions is as follows.
- PICKUP WINDOW
- Location and time range of expected pickup.
- PICKED UP
- Location and actual time of pickup.
- ARRIVED AT TERMINAL
- Location and actual time arrived at terminal.
- DEPARTED TERMINAL
- Location and actual time departed terminal.
- OUT FOR DELIVERY
- Location and actual time departed delivery terminal.
- DELIVERY APPOINTMENT WINDOW
- Location and time range of delivery appointment.
- ETA WINDOW
- Location and time range of expected delivery.
- DELIVERED
- Location and actual time of delivery.
Examples
The following example will request shipment status for Pyle Pro number 99999999.
https://api.aduiepyle.com/2/shipment/status?user=aduiepyle@aduiepyle.com&type=0&value=99999999
Sample Status
-Headers "Content-Type:application/json"
{
"shipmentStatus": {
"result": [
{
"pro": "99999999",
"billOfLadingNumber": "123456780",
"purchaseOrder": "654321",
"status": "SCHEDULED",
"statusDateTime": "2017-08-31T07:10:53",
"comment": "FOR DELIVERY TODAY STOP 7",
"consignee": {
"name": "A DUIE PYLE",
"address1": "45 E PARK DR",
"address2": "",
"city": "WESTAMPTON",
"state": "NJ",
"zip": "080605123"
},
"shipper": {
"name": "A DUIE PYLE",
"address1": "650 WESTTOWN RD",
"address2": "PO BOX 564",
"city": "WEST CHESTER",
"state": "PA",
"zip": "19381"
},
"billTo": {
"name": "A DUIE PYLE",
"address1": "650 WESTTOWN RD",
"address2": "PO BOX 564",
"city": "WEST CHESTER",
"state": "PA",
"zip": "19381"
},
"interlineFrom": "",
"interlineFromPro": "",
"interlineTo": "",
"interlineToPro": "",
"shipmentDetails": {
"weight": "670",
"pieces": "1"
},
"statusHistory": [
{
"description": "PICKUP WINDOW",
"location": "WEST CHESTER, PA",
"start": "2017-08-31T08:00:00",
"end": "2017-08-31T17:00:00"
},
{
"description": "PICKED UP",
"location": "WEST CHESTER, PA",
"start": "2017-08-31T13:00:00",
"end": "2017-08-31T13:00:00"
},
{
"description": "ARRIVED AT TERMINAL",
"location": "WEST CHESTER, PA",
"start": "2017-08-31T18:00:00",
"end": "2017-08-31T18:00:00"
},
{
"description": "OUT FOR DELIVERY",
"location": "",
"start": "2017-09-1T08:00:00",
"end": "2017-09-1T08:00:00"
},
{
"description": "ETA WINDOW",
"location": "",
"start": "2017-09-1T10:30:00",
"end": "2017-09-1T12:30:00"
}
]
}
]
}
}
-Headers "Content-Type:text/xml"
<?xml version="1.0" encoding="utf-8"?>
<shipmentStatus>
<result>
<pro>99999999</pro>
<billOfLadingNumber>123456780</billOfLadingNumber>
<purchaseOrder>654321</purchaseOrder>
<status>SCHEDULED</status>
<statusDateTime>2017-08-31T07:46:01</statusDateTime>
<comment>FOR DELIVERY TODAY STOP 7</comment>
<consignee>
<name>A DUIE PYLE</name>
<address1>45 E PARK DR</address1>
<address2></address2>
<city>WESTAMPTON</city>
<state>NJ</state>
<zip>080605123</zip>
</consignee>
<shipper>
<name>A DUIE PYLE</name>
<address1>650 WESTTOWN RD</address1>
<address2>PO BOX 564</address2>
<city>WEST CHESTER</city>
<state>PA</state>
<zip>19381</zip>
</shipper>
<billTo>
<name>A DUIE PYLE</name>
<address1>650 WESTTOWN RD</address1>
<address2>PO BOX 564</address2>
<city>WEST CHESTER</city>
<state>PA</state>
<zip>19381</zip>
</billTo>
<interlineFrom></interlineFrom>
<interlineFromPro></interlineFromPro>
<interlineTo></interlineTo>
<interlineToPro></interlineToPro>
<shipmentDetails>
<weight>670</weight>
<pieces>1</pieces>
</shipmentDetails>
<statusHistory>
<statusDetail>
<description>PICKUP WINDOW</description>
<location>WEST CHESTER, PA</location>
<start>2017-08-31T08:00:00</start>
<end>2017-08-31T17:00:00</end>
</statusDetail>
<statusDetail>
<description>PICKED UP</description>
<location>WEST CHESTER, PA</location>
<start>2017-08-31T13:00:00</start>
<end>2017-08-31T13:00:00</end>
</statusDetail>
<statusDetail>
<description>ARRIVED AT TERMINAL</description>
<location>WEST CHESTER, PA</location>
<start>2017-08-31T18:00:00</start>
<end>2017-08-31T18:00:00</end>
</statusDetail>
<statusDetail>
<description>OUT FOR DELIVERY</description>
<location></location>
<start>2017-09-1T08:00:00</start>
<end>2017-09-1T08:00:00</end>
</statusDetail>
<statusDetail>
<description>ETA WINDOW</description>
<location></location>
<start>2017-09-1T10:30:00</start>
<end>2017-09-1T12:30:00</end>
</statusDetail>
</statusHistory>
</result>
</shipmentStatus>
Revision 2 – 01/13/2020