UPS Time In Transit Virtual Sandbox

Get estimated delivery times for UPS shipping services between specified locations.

The Time In Transit API provides estimated delivery times for various UPS shipping services. It enables businesses to provide accurate delivery estimates to customers and aids in logistics planning by calculating transit times for different service levels.

Use this hosted sandbox to simulate UPS Time In Transit APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate transit time request payloads, handle origin-destination coordinate mapping, test service-level availability, and verify response parsing for various UPS shipping methods before integrating with production logistics workflows.

UPS Time In Transit virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate UPS Time In Transit responses instantly.

`https://ups-time-in-transit.mock.beeceptor.com`

Time in Transit

POST

/shipments/{version}/transittimes

TimeInTransit

Header Name	Example
`transId`*	`"ea nostrud sit ex proident"`
`transactionSrc`*	`"nisi Duis anim"`

Request Payload

{
  "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"
}

Response Payload

{
  "destinationPickList": [
    {
      "city": "anim id",
      "countryCode": "re",
      "countryName": "non",
      "postalCode": "ma",
      "postalCodeHigh": "proiden",
      "postalCodeLow": "de",
      "stateProvince": "fugiat consequat proident ",
      "town": "labore tempor qui"
    },
    {
      "city": "et magna occaecat ",
      "countryCode": "la",
      "countryName": "pariatur proident ma",
      "postalCode": "cillu",
      "postalCodeHigh": "eli",
      "postalCodeLow": "quis u",
      "stateProvince": "culpa dolore anim aliq",
      "town": "reprehenderit est"
    },
    {
      "city": "deserunt",
      "countryCode": "in",
      "countryName": "proident elit",
      "postalCode": "incididunt",
      "postalCodeHigh": "dolo",
      "postalCodeLow": "nisi",
      "stateProvince": "m",
      "town": "fugiat cillum ut proident"
    },
    {
      "city": "fugiat dolor",
      "countryCode": "ir",
      "countryName": "Duis u",
      "postalCode": "p",
      "postalCodeHigh": "do",
      "postalCodeLow": "exe",
      "stateProvince": "adipisicing eu proident nulla",
      "town": "mollit"
    }
  ],
  "emsResponse": {
    "billType": "cu",
    "destinationCityName": "non Ut aliqua consect",
    "destinationCountryCode": "id",
    "destinationCountryName": "sed",
    "destinationPostalCode": "mini",
    "destinationPostalCodeHigh": "eiu",
    "destinationPostalCodeLow": "Duis esse",
    "destinationStateProvince": "aut",
    "dutyType": "pa",
    "guaranteeSuspended": true,
    "numberOfServices": -43507752,
    "originCityName": "in reprehenderit deserunt exercitation",
    "originCountryCode": "do",
    "originCountryName": "amet veniam anim",
    "originPostalCode": "dolor",
    "originPostalCodeHigh": "inci",
    "originPostalCodeLow": "nulla ip",
    "originStateProvince": "ex",
    "residentialIndicator": "nu",
    "serviceLevel": "ad",
    "services": [
      {
        "businessTransitDays": -64810135,
        "commitTime": "anim ut ",
        "cstccutoffTime": "sed est ",
        "delayCount": -80141772,
        "deliveryDate": "nostrud en",
        "deliveryDayOfWeek": "iru",
        "deliveryTime": "fugiat n",
        "guaranteeIndicator": "e",
        "holidayCount": -55390268,
        "nextDayPickupIndicator": "d",
        "pickupDate": "auteexerci",
        "pickupTime": "ullamco ",
        "poddate": "sunt ipsum",
        "poddays": -17586974,
        "restDaysCount": -36473425,
        "saturdayDeliveryDate": "quis labor",
        "saturdayDeliveryTime": "tempor o",
        "saturdayPickupIndicator": "l",
        "serviceLevel": "ve",
        "serviceLevelDescription": "UPS Expedited",
        "serviceRemarksText": "adipisicing",
        "shipDate": "dolore ad ",
        "totalTransitDays": -30199480
      },
      {
        "businessTransitDays": -71832181,
        "commitTime": "minimadi",
        "cstccutoffTime": "consequa",
        "delayCount": -36019054,
        "deliveryDate": "elit enim ",
        "deliveryDayOfWeek": "lab",
        "deliveryTime": "esse par",
        "guaranteeIndicator": "a",
        "holidayCount": -23390098,
        "nextDayPickupIndicator": "l",
        "pickupDate": "Duis paria",
        "pickupTime": "elit Utp",
        "poddate": "esse minim",
        "poddays": -73295964,
        "restDaysCount": -19823190,
        "saturdayDeliveryDate": "proidental",
        "saturdayDeliveryTime": "cillum n",
        "saturdayPickupIndicator": "L",
        "serviceLevel": "ei",
        "serviceLevelDescription": "UPS Worldwide Express Freight",
        "serviceRemarksText": "aliquip nisi incididunt",
        "shipDate": "commodo es",
        "totalTransitDays": -25971384
      },
      {
        "businessTransitDays": -96938874,
        "commitTime": "consecte",
        "cstccutoffTime": "consequa",
        "delayCount": -50871773,
        "deliveryDate": "aliquip Ex",
        "deliveryDayOfWeek": "ven",
        "deliveryTime": "quiamet ",
        "guaranteeIndicator": "e",
        "holidayCount": -17940744,
        "nextDayPickupIndicator": "v",
        "pickupDate": "quis nulla",
        "pickupTime": "tempor d",
        "poddate": "est magna ",
        "poddays": -76629574,
        "restDaysCount": -2950824,
        "saturdayDeliveryDate": "aliqua id ",
        "saturdayDeliveryTime": "Utdolore",
        "saturdayPickupIndicator": "d",
        "serviceLevel": "et",
        "serviceLevelDescription": "UPS Expedited",
        "serviceRemarksText": "sunt Ut labore",
        "shipDate": "irure moll",
        "totalTransitDays": -78876857
      },
      {
        "businessTransitDays": -97847384,
        "commitTime": "eu minim",
        "cstccutoffTime": "pariatur",
        "delayCount": -99913884,
        "deliveryDate": "nostrud cu",
        "deliveryDayOfWeek": "vol",
        "deliveryTime": "sint dol",
        "guaranteeIndicator": "n",
        "holidayCount": -14496993,
        "nextDayPickupIndicator": "f",
        "pickupDate": "do sit eni",
        "pickupTime": "Excepteu",
        "poddate": "irure sunt",
        "poddays": -32485701,
        "restDaysCount": -84022816,
        "saturdayDeliveryDate": "laboreetDu",
        "saturdayDeliveryTime": "sedrepre",
        "saturdayPickupIndicator": "q",
        "serviceLevel": "vo",
        "serviceLevelDescription": "UPS Worldwide Express Freight",
        "serviceRemarksText": "ut pariatur",
        "shipDate": "aliquaLore",
        "totalTransitDays": -55406120
      },
      {
        "businessTransitDays": -80716409,
        "commitTime": "adipisic",
        "cstccutoffTime": "exercita",
        "delayCount": -76964081,
        "deliveryDate": "magna pari",
        "deliveryDayOfWeek": "ali",
        "deliveryTime": "dolor eu",
        "guaranteeIndicator": "e",
        "holidayCount": -92792952,
        "nextDayPickupIndicator": "a",
        "pickupDate": "dolorerepr",
        "pickupTime": "sint min",
        "poddate": "aliqua ess",
        "poddays": -21209605,
        "restDaysCount": -13495356,
        "saturdayDeliveryDate": "deserunt e",
        "saturdayDeliveryTime": "Duisnull",
        "saturdayPickupIndicator": "u",
        "serviceLevel": "oc",
        "serviceLevelDescription": "UPS Worldwide Express Freight",
        "serviceRemarksText": "occaecat velit ut cillum",
        "shipDate": "id do repr",
        "totalTransitDays": -28353160
      }
    ],
    "shipDate": "commodo ",
    "shipmentContentsCurrencyCode": "do ",
    "shipmentContentsValue": "ad volupta",
    "shipTime": "sint amet in",
    "weight": "mollit",
    "weightUnitOfMeasure": "do"
  },
  "originPickList": [
    {
      "city": "irure",
      "countryCode": "ci",
      "countryName": "enim et",
      "postalCode": "anim des",
      "postalCodeHigh": "minim occa",
      "postalCodeLow": "ex occa",
      "stateProvince": "magna in commodo",
      "town": "amet"
    },
    {
      "city": "Duis in et",
      "countryCode": "es",
      "countryName": "tempor anim",
      "postalCode": "labore ex ",
      "postalCodeHigh": "non ",
      "postalCodeLow": "ci",
      "stateProvince": "aliqua ad",
      "town": "ipsum proident in eiusmod Excep"
    }
  ],
  "validationList": {
    "destinationAmbiguous": true,
    "invalidFieldList": [
      "ipsum laboris nostrud in non",
      "veniam aliquip ut",
      "amet enim sunt deserunt"
    ],
    "invalidFieldListCodes": [
      "cupidatat",
      "laborum voluptate"
    ],
    "originAmbiguous": false
  }
}

{
  "errors": [
    {
      "code": "aliquip et",
      "message": "Shipment date out of range"
    },
    {
      "code": "ut mollit eu anim",
      "message": "Weight exceeds maximum allowed"
    },
    {
      "code": "amet mollit",
      "message": "Invalid origin country code"
    },
    {
      "code": "fugiat nulla minim occaecat tempor",
      "message": "Invalid origin country code"
    }
  ]
}

{
  "errors": [
    {
      "code": "occaecat Ut",
      "message": "Address validation failed"
    },
    {
      "code": "laborum sit tempor",
      "message": "Weight exceeds maximum allowed"
    },
    {
      "code": "eiusmod cupidatat ut ullamco",
      "message": "Weight exceeds maximum allowed"
    },
    {
      "code": "eiusmod",
      "message": "Address validation failed"
    },
    {
      "code": "nulla",
      "message": "Shipment date out of range"
    }
  ]
}

{
  "errors": [
    {
      "code": "ea est aliquip",
      "message": "Address validation failed"
    },
    {
      "code": "fugiat proident eu tempor",
      "message": "Address validation failed"
    },
    {
      "code": "do amet aliqua Lorem commodo",
      "message": "Invalid origin country code"
    },
    {
      "code": "laboris Duis Excepteur",
      "message": "Address validation failed"
    },
    {
      "code": "sint ipsum ex reprehenderit occaecat",
      "message": "Address validation failed"
    }
  ]
}

{
  "errors": [
    {
      "code": "ad",
      "message": "Address validation failed"
    }
  ]
}

Service Homepage: github.com/UPS-API/api-documentation/blob/main/TimeInTransit.yaml

upslogisticsshippingtransitdelivery