Tracking

AI Tools

uShip provides three options for receiving tracking statuses and relevant data for your shipments. Please see the table below for detail on each of these options and which would best suit your integration plan. For each option, the transit statuses available are: ReadyForDispatch, Dispatched, PickedUp, Delivered . As uShip's model focuses on a single carrier from origin to destination, there are not waypoints or other steps noted.


Tracking Link Generation

Status Retrieval

Full Tracking Data

Visible to unauthenticated users?

Account owners can generate a link that unauthenticated users can view

You can retrieve tracking data for listings not under your uShip account

Tracking data can only be retrieved for listings on your uShip account

Displays transit status?

Yes

Yes

Yes

Allows data to be shown on your page?

You can only display the link to the uShip hosted tracking page

Yes, you can surface specific parameters on your page. Users will not need to leave your site.

Yes, you can surface specific parameters on your page. Users will not need to leave your site.

Supports location data?

Yes, if carrier enables location services

No

Yes, if carrier enables location services

Additional documentation

Please request the tracking link slide deck from your account or integrations manager

See sample JSON Payload response below

https://uship.developerhub.io/uship-furniture-api-reference/ref#getretrieve-tracking-info

Status Retrieval Example Users authenticate with password grant token and use endpoint GET v2/listings/{listingID} to retrieve payload values as shown below

{ "status": { "value": "Booked", "label": "Booked", "shortLabel": "Booked" }, "transitStatus": { "value": "ReadyForDispatch", "label": "Booked", "shortLabel": "Booked" }, "namedPrice": { "value": 60.01, "label": "$60.01", "shortLabel": "$61", "currencyType": { "value": "USD", "label": "US Dollar", "shortLabel": "US Dollar" } }, "offerPrice": { "offerType": { "value": "Offer", "label": "Offer", "shortLabel": "Offer" }, "value": 60.01, "label": "$60.01", "shortLabel": "$61", "currencyType": { "value": "USD", "label": "US Dollar", "shortLabel": "US Dollar" } }, "commodity": "Furniture", "parentCommodity": "Household Goods", "topLevelCommodity": "Household Goods", "expiresOn": "2020-10-23T04:59:59Z", "imageUrl": "https://s.ushipcdn.com/public/images/icons/categories/114x138/1_114x138.png", "isDefaultImage": true, "checksum": "d131bab40a8f368d", "createdOn": "2020-10-22T16:46:34Z", "activatedOn": "2020-10-22T16:46:34Z", "lastUpdatedOn": "2020-10-22T16:46:34Z", "minimumBidAmount": { "value": 19.99, "label": "$19.99", "shortLabel": "$20", "currencyType": { "value": "USD", "label": "US Dollar", "shortLabel": "US Dollar" } }, "quoteRequestId": "5f91b76a4eeb8a22707a04ad", "commodityType": { "value": "Furniture", "label": "Furniture", "shortLabel": "Furniture" }, "parentCommodityType": { "value": "HouseholdGoods", "label": "Household Goods", "shortLabel": "Household Goods" }, "topLevelCommodityType": { "value": "HouseholdGoods", "label": "Household Goods", "shortLabel": "Household Goods" }, "serviceTypes": [ { "value": "BlanketWrap", "label": "Blanket Wrap", "shortLabel": "Blanket Wrap" } ], "listingId": 723558412, "title": "Marble Top Side Table B-5940546", "description": "**PLEASE CONFIRM YOU HAVE READ THESE DETAILS IN BID**:\r\n- Pickup is between 10:00 AM-5:00 PM Mon-Fri \r\n- Pickup is from a warehouse, ground level, no loading dock. \r\n- You MUST be able to load and unload the item(s) without the assistance of our employees or our customers. \r\n- You MUST use the BOL which can be found in My Shipments under the Assigned Tab. Print the BOL and fill out the necessary information. \r\n- You MUST make contact with the delivery customer at least 24 hours in advance. If you deliver an item less than 24 hours from pickup without the customer’s approval, you will not be paid in full. \r\n- Items can not be left outside unless consent is given from the customer. \r\n- Customers should be contacted between 7:30am-8:30pm based on the delivery timezone. \r\n- An enclosed trailer, box truck, or sprinter van is required for ALL deliveries.\r\n- Threshold delivery.\r\n- IF ANY OF THESE REQUIREMENTS ARE NOT MET, WE WILL NO LONGER BE ABLE TO WORK TOGETHER.\r\n*(please note that all weights are estimated)", "route": { "distance": { "kilometers": 53.1082, "label": "33 mi.", "shortLabel": "33 mi." }, "items": [ { "address": { "streetAddress": "20 Terry Ave", "alternateStreetAddress": "", "majorMunicipality": "Burlington", "postalCode": "01803", "stateProvince": "MA", "stateProvinceLabel": "Massachusetts", "country": "US", "countryLabel": "United States", "latitude": 42.5095, "longitude": -71.20192, "label": "Burlington, MA 01803 US", "shortLabel": "Burlington, MA 01803 US", "type": { "value": "BusinessWithoutLoadingDockOrForklift", "label": "Business (without loading dock or forklift)", "shortLabel": "Business (without loading dock or forklift)" } }, "contact": { "name": "", "phoneNumber": "" }, "timeFrame": { "label": "Between 10/22/2020 - 10/22/2020", "shortLabel": "10/22 - 10/22", "earliestArrival": "2020-10-22T05:00:00Z", "latestArrival": "2020-10-22T05:00:00Z", "timeFrameType": { "value": "between", "label": "Between", "shortLabel": "Between" }, "timeZone": "America/New_York" }, "accessorials": [] }, { "address": { "streetAddress": "28 E Nashua Rd", "majorMunicipality": "Windham", "postalCode": "03087", "stateProvince": "NH", "stateProvinceLabel": "New Hampshire", "country": "US", "countryLabel": "United States", "latitude": 42.83313, "longitude": -71.30716, "label": "Windham, NH 03087 US", "shortLabel": "Windham, NH 03087 US", "type": { "value": "Residence", "label": "Residence / Home Business", "shortLabel": "Residence / Home Business" } }, "contact": { "name": "Jami Vetter jamie.vetter@gmail.com", "phoneNumber": "+17038357821" }, "timeFrame": { "label": "Between 10/22/2020 - 10/22/2020", "shortLabel": "10/22 - 10/22", "earliestArrival": "2020-10-22T05:00:00Z", "latestArrival": "2020-10-22T05:00:00Z", "timeFrameType": { "value": "between", "label": "Between", "shortLabel": "Between" }, "timeZone": "America/New_York" }, "accessorials": [] } ] }, "lister": { "userId": 259473378, "displayName": "AfterShip S.", "profileUrl": "/profile/259473378", "feedback": {}, "dateCreated": "2020-05-04T10:05:33Z", "companyLocation": {}, "links": [ { "rel": "Item", "verb": "GET", "href": "/v2/users/259473378/profile", "title": "profile" } ] }, "items": [ { "title": "Marble Top Side Table 19BOS018-042", "commodity": { "value": "Furniture", "label": "Furniture", "shortLabel": "Furniture" }, "attributes": { "lengthInMeters": { "title": "Length", "value": 0.457, "label": "1 ft 6 in.", "shortLabel": "1 ft 6 in." }, "widthInMeters": { "title": "Width", "value": 0.660, "label": "2 ft 2 in.", "shortLabel": "2 ft 2 in." }, "heightInMeters": { "title": "Height", "value": 0.558, "label": "1 ft 10 in.", "shortLabel": "1 ft 10 in." }, "weightInGrams": { "title": "Weight", "value": 40820.0, "label": "90 lbs", "shortLabel": "90 lbs" }, "unitCount": { "title": "Quantity", "value": 1, "label": "1", "shortLabel": "1" } } } ], "totalWeightInGrams": { "value": 40820.0, "label": "90 lbs", "shortLabel": "90 lbs" }, "attributes": { "crated": { "title": "Crated", "value": false, "label": "No", "shortLabel": "No" }, "stackable": { "title": "Stackable", "value": false, "label": "No", "shortLabel": "No" }, "palletized": { "title": "Palletized", "value": false, "label": "No", "shortLabel": "No" } }, "referenceNumbers": [ { "number": "6a8a7b9d-68e3-4ebc-9f26-4b3bfa7688b5", "type": { "value": "PriceCorrelationId", "label": "Fixed Pricing", "shortLabel": "Fixed Pricing" } } ], "links": [ { "rel": "Update", "verb": "PUT", "href": "/v2/listings/723558412/pickup", "title": "pickup" }, { "rel": "Update", "verb": "PUT", "href": "/v2/listings/723558412/delivery", "title": "delivery" }, { "rel": "List", "verb": "GET", "href": "/v2/listings/723558412/conversations", "title": "listingconversations" }, { "rel": "Delete", "verb": "DELETE", "href": "/v2/listings/723558412", "title": "deleteListing" }, { "rel": "Update", "verb": "PUT", "href": "/v2/listings/723558412", "title": "updateListing" }, { "rel": "Create", "verb": "POST", "href": "/v2/listings/723558412?marketId=0", "title": "listSimilarShipment" }, { "rel": "Item", "verb": "GET", "href": "/v2/listings/723558412", "title": "viewListing" }, { "rel": "Update", "verb": "PUT", "href": "/v2/listings/723558412/pricingstatus", "title": "unlist" } ] }


On This Page
Tracking