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`*	`"commodo do deserunt in mollit"`
`transactionSrc`*	`"laborum non occaecat Ut"`

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": "nisi commodo",
      "countryCode": "ad",
      "countryName": "laboris nisi esse in",
      "postalCode": "ut",
      "postalCodeHigh": "in",
      "postalCodeLow": "reprehende",
      "stateProvince": "veniam laborum magna in",
      "town": "Ut adipisicing dolor"
    },
    {
      "city": "Lorem labore et esse cupidatat",
      "countryCode": "la",
      "countryName": "dolore in nulla amet",
      "postalCode": "minim in",
      "postalCodeHigh": "eiusmod",
      "postalCodeLow": "dolo",
      "stateProvince": "Duis Excepteur eiusmod proident",
      "town": "laboris Lorem"
    },
    {
      "city": "laboris",
      "countryCode": "en",
      "countryName": "proident ",
      "postalCode": "ea i",
      "postalCodeHigh": "veniam pa",
      "postalCodeLow": "incidi",
      "stateProvince": "enim c",
      "town": "consectetur ut"
    },
    {
      "city": "dolor aliquip dolor",
      "countryCode": "al",
      "countryName": "tempor cillum",
      "postalCode": "Duis",
      "postalCodeHigh": "s",
      "postalCodeLow": "u",
      "stateProvince": "aute",
      "town": "sunt irure Duis sit"
    }
  ],
  "emsResponse": {
    "billType": "do",
    "destinationCityName": "ipsum ",
    "destinationCountryCode": "Du",
    "destinationCountryName": "nisi in ullamco",
    "destinationPostalCode": "in ",
    "destinationPostalCodeHigh": "laborum",
    "destinationPostalCodeLow": "amet",
    "destinationStateProvince": "ut pariatur",
    "dutyType": "et",
    "guaranteeSuspended": true,
    "numberOfServices": -94227675,
    "originCityName": "esse velit",
    "originCountryCode": "al",
    "originCountryName": "voluptate ex dolore ad",
    "originPostalCode": "ut",
    "originPostalCodeHigh": "ullamc",
    "originPostalCodeLow": "Excepteur",
    "originStateProvince": "ex i",
    "residentialIndicator": "cu",
    "serviceLevel": "d",
    "services": [
      {
        "businessTransitDays": -93055881,
        "commitTime": "anim ame",
        "cstccutoffTime": "elit ute",
        "delayCount": -81061841,
        "deliveryDate": "reprehende",
        "deliveryDayOfWeek": "off",
        "deliveryTime": "est sunt",
        "guaranteeIndicator": "a",
        "holidayCount": -79406300,
        "nextDayPickupIndicator": "a",
        "pickupDate": "ut ad cons",
        "pickupTime": "qui mini",
        "poddate": "animenim c",
        "poddays": -25112012,
        "restDaysCount": -12172645,
        "saturdayDeliveryDate": "occaecatEx",
        "saturdayDeliveryTime": "pariatur",
        "saturdayPickupIndicator": "d",
        "serviceLevel": "mi",
        "serviceLevelDescription": "UPS Ground",
        "serviceRemarksText": "in esse in",
        "shipDate": "ea suntali",
        "totalTransitDays": -37702175
      },
      {
        "businessTransitDays": -21154307,
        "commitTime": "sed proi",
        "cstccutoffTime": "fugiat e",
        "delayCount": -53881644,
        "deliveryDate": "ineiusmodf",
        "deliveryDayOfWeek": "ess",
        "deliveryTime": "ad occae",
        "guaranteeIndicator": "r",
        "holidayCount": -45537344,
        "nextDayPickupIndicator": "m",
        "pickupDate": "labore lab",
        "pickupTime": "Duis par",
        "poddate": "nostrud de",
        "poddays": -56456294,
        "restDaysCount": -6374414,
        "saturdayDeliveryDate": "fugiat nos",
        "saturdayDeliveryTime": "non dolo",
        "saturdayPickupIndicator": "e",
        "serviceLevel": "ve",
        "serviceLevelDescription": "UPS Next Day Air",
        "serviceRemarksText": "officia sit",
        "shipDate": "commodorep",
        "totalTransitDays": -61569483
      }
    ],
    "shipDate": "elit ess",
    "shipmentContentsCurrencyCode": "ven",
    "shipmentContentsValue": "of",
    "shipTime": "esse ut aute ut",
    "weight": "d",
    "weightUnitOfMeasure": "dol"
  },
  "originPickList": [
    {
      "city": "consequat in id s",
      "countryCode": "la",
      "countryName": "non ipsum",
      "postalCode": "adipisi",
      "postalCodeHigh": "proident",
      "postalCodeLow": "n",
      "stateProvince": "occaecat",
      "town": "sunt ea ut sed"
    },
    {
      "city": "aliquip cillum et nostrud commodo",
      "countryCode": "pr",
      "countryName": "elit dolore",
      "postalCode": "veli",
      "postalCodeHigh": "i",
      "postalCodeLow": "labor",
      "stateProvince": "dolor",
      "town": "sit et"
    },
    {
      "city": "magna",
      "countryCode": "co",
      "countryName": "est labore ex",
      "postalCode": "en",
      "postalCodeHigh": "eiu",
      "postalCodeLow": "ex a",
      "stateProvince": "dolore",
      "town": "nostrud "
    }
  ],
  "validationList": {
    "destinationAmbiguous": false,
    "invalidFieldList": [
      "irure",
      "mollit Duis ut"
    ],
    "invalidFieldListCodes": [
      "anim est Excepteur commodo pariatur",
      "anim pariatur velit irure"
    ],
    "originAmbiguous": true
  }
}

{
  "errors": [
    {
      "code": "dolor ex quis veniam eiusmod",
      "message": "Weight exceeds maximum allowed"
    },
    {
      "code": "Excepteur tempor sed adipisicing",
      "message": "Invalid origin country code"
    }
  ]
}

{
  "errors": [
    {
      "code": "fugiat amet sed",
      "message": "Weight exceeds maximum allowed"
    },
    {
      "code": "dolore ex id",
      "message": "Weight exceeds maximum allowed"
    },
    {
      "code": "do amet in sint",
      "message": "Address validation failed"
    },
    {
      "code": "dolor labore",
      "message": "Invalid origin country code"
    },
    {
      "code": "in magna mollit consequat",
      "message": "Address validation failed"
    }
  ]
}

{
  "errors": [
    {
      "code": "qui enim culpa",
      "message": "Shipment date out of range"
    },
    {
      "code": "mollit amet do magna consequat",
      "message": "Address validation failed"
    },
    {
      "code": "reprehenderit incididunt culpa nisi",
      "message": "Shipment date out of range"
    },
    {
      "code": "minim",
      "message": "Shipment date out of range"
    }
  ]
}

{
  "errors": [
    {
      "code": "consequat enim",
      "message": "Invalid origin country code"
    },
    {
      "code": "ut fugiat dolor cillum",
      "message": "Shipment date out of range"
    },
    {
      "code": "est ullamco fugiat dolore",
      "message": "Shipment date out of range"
    }
  ]
}

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

upslogisticsshippingtransitdelivery