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.


Type 0 - Pyle Pro number

Using the Pyle Pro number is the quickest way to obtain the shipment status information.

GET
/2/shipment/status
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.

GET
/2/shipment/status
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
GET
/2/shipment/status
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.

GET
/2/shipment/status
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

GET
/2/shipment/status
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"
          }
        ]
      }
    ]
  }
}

Revision 2 – 01/13/2020