returns a guaranteed landed cost quote

curl -X POST https://wwwcie.ups.com/api/brokerage/v1/content/glc/request-quote \
     -H "transId: 0a1b9c2d8e3f7g4h6i5" \
     -H "transactionSrc: EWS" \
     -H "Accept: application/json" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "shipperCurrencyCode": "CAD",
  "shipperAccountNumber": " ",
  "shipment": {
    "importCountryCode": "US",
    "exportCountryCode": "CA",
    "shipperAddress": {
      "addressLine1": "311 102 St",
      "countryCode": "AB",
      "name": "IKEA Edmonton",
      "addressLine2": "NW",
      "postalCode": "AB T6N 1M",
      "city": "Edmonton",
      "stateProvinceCode": "ON"
    },
    "shipToAddress": {
      "addressLine1": "55 Glenlake Pkwy",
      "countryCode": "US",
      "addressLine2": "NE",
      "city": "Sandy Springs",
      "name": "UPS",
      "postalCode": "30328",
      "residentialAddressIndicator": false,
      "stateProvinceCode": "GA"
    },
    "shipmentItems": [
      {
        "unitPrice": {
          "value": 1999,
          "currencyCode": "USD"
        },
        "quantity": {
          "value": 12,
          "unitOfMeasure": "pallets"
        },
        "partNumber": "40093ADA2",
        "originCountryCode": "GB",
        "grossWeight": {
          "value": 1250,
          "unitOfMeasure": "kg"
        },
        "description": "Surcoil Hose - Flush End - Long",
        "dimension": {
          "length": 48,
          "width": 48,
          "height": 60,
          "unitOfMeasure": "IN"
        }
      },
      {
        "unitPrice": {
          "value": 1000,
          "currencyCode": "USD"
        },
        "quantity": {
          "value": 10,
          "unitOfMeasure": "barrels"
        },
        "partNumber": "AF4535635",
        "originCountryCode": "GB",
        "grossWeight": {
          "value": 1500,
          "unitOfMeasure": "lb"
        },
        "description": "Cord 5mm PK50 Yellow/Red",
        "dimension": {
          "length": 24,
          "width": 24,
          "height": 36,
          "unitOfMeasure": "IN"
        }
      }
    ],
    "importProvince": "AB",
    "shipDate": "2024-04-01",
    "transModes": "INT_AIR",
    "transportCost": {
      "value": 999,
      "currencyCode": "USD"
    },
    "insuranceCost": {
      "value": 3000,
      "currencyCode": "USD"
    },
    "shipmentType": "Sale"
  },
  "buyerCurrencyCode": "USD",
  "serviceLevelCode": "01",
  "referenceNumber": "mar20240502"
}'

{
  "quoteId": "QUOTE1233445",
  "quoteCreationTimestamp": "2024-05-08T17:02:43+0000",
  "quoteExpirationDate": "2024-05-08",
  "gcTotal": [
    {
      "currencyCode": "USD",
      "type": "Shipper",
      "value": 89.2
    },
    {
      "currencyCode": "CAD",
      "type": "Buyer",
      "value": 100.2
    }
  ],
  "referenceNumber": "aaaaaaaaaaaaaaa33"
}

This endpoint requests guaranteed quotes for landed cost duties and taxes.

Authentication

AuthorizationBearer

“Find your Client ID and Secret on your app info page.

Select \“Try It\”
In the Security section enter your Client ID and Secret.
Select \“Request Token\”
Enter any additional information in the Body and Parameters sections.
Select \“Send\” to execute your API request”

Headers

Request

This endpoint expects an object.

shipperCurrencyCodestringRequiredformat: "^[A-Z]{3}$"=3 characters

Shipper’s currency code adhering to ISO 4217 standard. Click here for more information.

shipperAccountNumberstringRequired=6 characters

The Shipper's UPS Account Number.

shipmentobjectRequired

buyerCurrencyCodestringOptionalformat: "^[A-Z]{3}$"=3 characters

Buyer’s currency code adhering to ISO 4217 standard. Click here for more information.

serviceLevelCodeenumOptional

The code for the UPS Service associated with the shipment. Click here for more information.

referenceNumberstringOptional<=512 characters

A unique identifier used by clients for internal tracking.

Response headers

application/jsonstringOptional

Response

Request successful

quoteIdstring<=32 characters

unique quote id.

quoteCreationTimestampstringformat: "datetime"=24 characters

Timestamp for quote generation(UTC).

quoteExpirationDatedate

Date after which the quote is no longer valid. yyyy-mm-dd format.

gcTotallist of objects

array for buyer and billing Global checkout total items.

referenceNumberstringOptional<=512 characters

A reference for customer internal tracking from the request .

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error