Shipment Status Web Service
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.
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=1&value=bill-of-lading-number&zip=origination-zip
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=1&value=bill-of-lading-number&zip=origination-zip
Statuses
The possible list of statuses is as follows.
- Name
SCHEDULED
- Description
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.
- Name
UNSCHEDULED
- Description
The freight has not yet been assigned to a delivery manifest and is most likely on our dock somewhere.
- Name
DELIVERED
- Description
Pyle has delivered the pro to the consignee location.
- Name
ATTEMPTED DELIVERY
- Description
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.
- Name
IN TRANSIT
- Description
Shipment is in transit to a third party carrier.
- Name
OUT FOR DELIVERY
- Description
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 #.
- Name
PICKED UP
- Description
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.
- Name
NO FREIGHT
- Description
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.
- Name
PICKUP WINDOW
- Description
Location and time range of expected pickup.
- Name
PICKED UP
- Description
- Location and actual time of pickup.
- Name
ARRIVED AT TERMINAL
- Description
Location and actual time arrived at terminal.
- Name
DEPARTED TERMINAL
- Description
Location and actual time departed terminal.
- Name
OUT FOR DELIVERY
- Description
Location and actual time departed delivery terminal.
- Name
DELIVERY APPOINTMENT
- Description
Location and time range of delivery appointment.
- Name
WINDOW
- Description
- Name
ETA WINDOW
- Description
Location and time range of expected delivery.
- Name
DELIVERED
- Description
- Location and actual time of delivery.
Examples
The following example will request shipment status for Pyle Pro number 99999999.
Example cURL Request
curl -G https://api.aduiepyle.com/2/shipment/status \
-H "Content-Type:application/json" \
-d user="aduiepyle@aduiepyle.com" \
-d type=0 \
-d value=99999999
Example Response
{
"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"
}
]
}
]
}
}
Please note that EDI Services and Web Services are not available between 12 Midnight and 12:15 AM Eastern Time during our server maintenance window.
All customers using the Web Services should sign up for Web Services Notification to be informed whenever one of the Web Service interfaces is updated.
Revision 2 – 01/13/2020