Resource

https://api.warehousefs.com/public/v1/tracking/{identificationNo}

The tracking resource allows the merchant to view real-time tracking information about a parcel. Instead of having to query different APIs for USPS, UPS, and FedEx tracking numbers, the merchant can use a single Shipvine Logistics API that abstracts away the carrier method systems.

GET

Request

URL Template

The {identificationNo} in the URL template should be replaced with the appropriate tracking number.

Example Request URL

https://api.warehousefs.com/public/v1/tracking/9101148009900286958525

Query Parameters

No query parameters may be included in the request.

Entity Body

No entity body may be includedin the request.

Response

If successful, the API will return 200 OK as well as a <Tracking /> element in the entity body. See the XML schema for details about that element.

If any error occurs, the HTTP status code will not be 200 OK. An <Errors /> element may be present in the entity body.

A 404 Not Found response is typical for carriers that do not support real-time tracking or for requests that are made soon after the outbound shipment has been created. (Some carriers, such as USPS, take up to one day for information to be available in their systems.)

Example Response Entity Body

<?xml version="1.0" encoding="utf-8"?>
<Tracking xmlns="urn:WarehouseFS-1.0">
  <Status>EnRoute</Status> < -- (1) -- >
  <Waypoints> < -- (2) -- >
    <Waypoint>
      <TransactedAtLocal>2009-10-15T07:00:00</TransactedAtLocal>
      <Location>ENGLEWOOD, CO  80110</Location>
      <Note>Arrival at Unit</Note>
    </Waypoint>
    <Waypoint>
      <TransactedAtLocal>2009-10-14T21:19:00</TransactedAtLocal>
      <Location>DENVER, CO  80217</Location>
      <Note>Processed through Sort Facility</Note>
    </Waypoint>
    <Waypoint>
      <TransactedAtLocal>2009-10-14T01:09:00</TransactedAtLocal>
      <Location>BOULDER, CO  80302</Location>
      <Note>Electronic Shipping Info Received</Note>
    </Waypoint>
  </Waypoints>
</Tracking>

1. The current status of the shipment. The current possible values are Unknown (which indicates an exceptional status code), Pending (which indicates a newly-created outbound shipment), EnRoute, Delivered, and Problem (which indicates a delivery exception.
2. Each <Waypoint /> element, if any, provides a textual description and location that details the parcel's progress. While Shipvine Logistics prefers to use universal coordinated time (UTC) for all date and time fields, it has been Shipvine's experience that the vast majority of carriers return tracking data in time relative to the location of the tracking event. Therefore, all times returned in this resource are local time. Not all carriers record timestamps, and the <TransactedAtLocal /> element may be missing or empty.