Time In Transit Example Request
POST {{base_url}}/api/shipments/:version/transittimes
This HTTP POST request will return a list of services and the time those services will take to move a package from a given origin to a given destination. Package details provided will sometimes change what services are available for a given lane (origin-destination pair).
Request Body
{"originCountryCode"=>"DE", "originStateProvince"=>"", "originCityName"=>"", "originTownName"=>"", "originPostalCode"=>"10703", "destinationCountryCode"=>"US", "destinationStateProvince"=>"NH", "destinationCityName"=>"MANCHESTER", "destinationTownName"=>"", "destinationPostalCode"=>"03104", "weight"=>"10.5", "weightUnitOfMeasure"=>"LBS", "shipmentContentsValue"=>"10.5", "shipmentContentsCurrencyCode"=>"USD", "billType"=>"03", "shipDate"=>"2019-05-01", "shipTime"=>"", "residentialIndicator"=>"", "avvFlag"=>true, "numberOfPackages"=>"1"}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
transId | null | An identifier unique to the request. Length 32 | |
transactionSrc | string | An identifier unique to the request. Length 32 | |
Content-Type | string |
RESPONSES
status: OK
{"emsResponse":{"shipDate":"2024-02-01","shipTime":"11:15:43","billType":"03","dutyType":"09","residentialIndicator":"02","destinationCityName":"MANCHESTER","destinationCountryName":"UNITED STATES","destinationCountryCode":"US","destinationPostalCode":"03104","destinationPostalCodeLow":"03104","destinationPostalCodeHigh":"03104","destinationStateProvince":"NH","originCityName":"BERLIN","originCountryName":"GERMANY","originCountryCode":"DE","originPostalCode":"10703","originStateProvince":"BERLIN","shipmentContentsCurrencyCode":"USD","weightUnitOfMeasure":"LBS","weight":"10.5","shipmentContentsValue":"10.5","guaranteeSuspended":false,"numberOfServices":6,"services":[{"serviceLevel":"01","serviceLevelDescription":"UPS Worldwide Express","businessTransitDays":2,"totalTransitDays":4,"deliveryDate":"2024-02-03","deliveryTime":"12:00:00","deliveryDayOfWeek":"SAT","nextDayPickupIndicator":"0","saturdayPickupIndicator":"0","saturdayDeliveryIndicator":"1","saturdayDeliveryDate":"2024-02-03","saturdayDeliveryTime":"12:00:00","guaranteeIndicator":"1","restDaysCount":2,"holidayCount":0,"delayCount":0,"commitTime":"12:00:00","serviceRemarksText":"SATURDAY DELIVERY EXTRA CHARGE10KG \u0026 25KG BOX SRVC AVAIL ","shipDate":"2024-02-01","pickupTime":"20:00:00","pickupDate":"2024-02-01","poddate":"2024-02-06","poddays":1,"cstccutoffTime":"18:00:00"},{"serviceLevel":"21","serviceLevelDescription":"UPS Express Plus®","businessTransitDays":2,"totalTransitDays":4,"deliveryDate":"2024-02-05","deliveryTime":"08:00:00","deliveryDayOfWeek":"MON","nextDayPickupIndicator":"0","saturdayPickupIndicator":"0","saturdayDeliveryIndicator":"0","saturdayDeliveryTime":"00:00:00","guaranteeIndicator":"1","restDaysCount":2,"holidayCount":0,"delayCount":0,"commitTime":"08:00:00","shipDate":"2024-02-01","pickupTime":"20:00:00","pickupDate":"2024-02-01","poddate":"2024-02-06","poddays":1,"cstccutoffTime":"18:00:00"},{"serviceLevel":"01","serviceLevelDescription":"UPS Express®","businessTransitDays":2,"totalTransitDays":4,"deliveryDate":"2024-02-05","deliveryTime":"10:30:00","deliveryDayOfWeek":"MON","nextDayPickupIndicator":"0","saturdayPickupIndicator":"0","saturdayDeliveryIndicator":"0","sundayDeliveryIndicator":"0","guaranteeIndicator":"1","restDaysCount":2,"holidayCount":0,"delayCount":0,"commitTime":"10:30:00","serviceRemarksText":"SATURDAY DELIVERY EXTRA CHARGE10KG \u0026 25KG BOX SRVC AVAIL ","shipDate":"2024-02-01","pickupTime":"20:00:00","pickupDate":"2024-02-01","poddate":"2024-02-06","poddays":1,"cstccutoffTime":"18:00:00"},{"serviceLevel":"28","serviceLevelDescription":"UPS Express Saver","businessTransitDays":2,"totalTransitDays":4,"deliveryDate":"2024-02-05","deliveryTime":"23:30:00","deliveryDayOfWeek":"MON","nextDayPickupIndicator":"0","saturdayPickupIndicator":"0","saturdayDeliveryIndicator":"0","saturdayDeliveryTime":"00:00:00","guaranteeIndicator":"1","restDaysCount":2,"holidayCount":0,"delayCount":0,"commitTime":"23:30:00","serviceRemarksText":"10KG \u0026 25KG BOX SRVC AVAIL ","shipDate":"2024-02-01","pickupTime":"20:00:00","pickupDate":"2024-02-01","poddate":"2024-02-06","poddays":1,"cstccutoffTime":"18:00:00"},{"serviceLevel":"29","serviceLevelDescription":"UPS Worldwide Express Freight","businessTransitDays":2,"totalTransitDays":4,"deliveryDate":"2024-02-05","deliveryTime":"23:30:00","deliveryDayOfWeek":"MON","nextDayPickupIndicator":"0","saturdayPickupIndicator":"0","saturdayDeliveryIndicator":"0","saturdayDeliveryTime":"00:00:00","guaranteeIndicator":"1","restDaysCount":2,"holidayCount":0,"delayCount":0,"commitTime":"23:30:00","shipDate":"2024-02-01","pickupTime":"17:00:00","pickupDate":"2024-02-01","poddate":"2024-02-06","poddays":1,"cstccutoffTime":"15:00:00"},{"serviceLevel":"05","serviceLevelDescription":"UPS Expedited","businessTransitDays":4,"totalTransitDays":6,"deliveryDate":"2024-02-07","deliveryTime":"23:30:00","deliveryDayOfWeek":"WED","nextDayPickupIndicator":"0","saturdayPickupIndicator":"0","saturdayDeliveryIndicator":"0","saturdayDeliveryTime":"00:00:00","guaranteeIndicator":"0","restDaysCount":2,"holidayCount":0,"delayCount":0,"commitTime":"23:30:00","serviceRemarksText":"IF GUARANTEE IS NO, THEN GUARANTEE WILL APPLY FOR US PAYERS ONLY ","shipDate":"2024-02-01","pickupTime":"20:00:00","pickupDate":"2024-02-01","poddate":"2024-02-08","poddays":1,"cstccutoffTime":"18:00:00"}]}}