Cart

Request rates for shipping, duties, and taxes for an order

Brands can send information to this endpoint to receive rates (shipping, duties & taxes) for an order. Rates can be configured by contacting Passport for each country & service level:

  • Shipping: Live, flat, free, free with threshold
  • Duties: Live, free
  • Taxes: Live, free

Rates can also be received in the desired local currency.

post/cart

Request

  • Base URL: https://api-stg.passportshipping.com/custom/v1
  • URL: https://api-stg.passportshipping.com/custom/v1/cart
  • Auth: none declared

Request body

referencestring

Unique identifier for the request.

service_name'StandardDdu' | 'StandardDduDelcon' | 'PriorityDdu' | 'PriorityDduDelcon' | 'PriorityDdp' | 'PriorityDdpDelcon' | 'epacketDdp' | 'ExpressDdp' | 'GlobalPlus' | 'ExpeditedDdpDelcon' | 'ExpressDdpDelcon' | 'ExpeditedDduDelcon' | 'ExpressDduDelcon'

The name of shipping service requested. If left empty, will return all shipping services configured for the brand.

contents_type'merchandise' | 'returned_goods' | 'documents' | 'gift' | 'goods' | 'other' | 'sample'

Describes the type of shipment content for goods clarification at customs.

presentment_currencystring

The currency to which all amounts should be converted to.

Example request

{
  "reference": "ORDER12345",
  "service_name": "Express",
  "contents_type": "merchandise",
  "presentment_currency": "EUR",
  "address_from": {
    "street1": "123 Main St",
    "street2": "Apt 4B",
    "city": "Los Angeles",
    "state": "CA",
    "zip": "90045",
    "country": "US",
    "company": "Sender Inc.",
    "name": "Alice Johnson"
  },
  "address_to": {
    "street1": "81 Bay Street",
    "city": "Toronto",
    "state": "ON",
    "zip": "M5J0E7",
    "country": "Canada",
    "name": "Bob Smith",
    "phone": "555-987-6543",
    "email": "bob@example.com",
    "pudo_id": "PUDO-123456"
  },
  "parcel": {
    "length": 10.5,
    "width": 5.2,
    "height": 1.1,
    "weight": 10.15
  },
  "items": [
    {
      "description": "Black T-Shirt",
      "hs_code": "9505900000",
      "sku": "TSHIRT123",
      "non_standard_manufacturer_product_id": "MFR-SKU-12345",
      "standard_manufacturer_product_id": "0012345678905",
      "quantity": 2,
      "value": 24.68,
      "weight": 1,
      "origin": "US"
    }
  ]
}

Response

(OK) Rates calculated successfully

request_idstring required

Unique identifier for tracking the API request.

currencystring required

The currency in which all returned prices are converted.

Example response

{
  "request_id": "682302a7-6c05-438f-ae8e-9b8cffc054b2",
  "currency": "EUR",
  "rates": [
    {
      "service_name": "Passport Priority Duties and Taxes Paid",
      "service_code": "PriorityDdpDelcon",
      "rate": 9,
      "duty": 6,
      "insurance": 1,
      "formatted": {
        "rate": "€9",
        "tax": "€0",
        "duty": "€6",
        "insurance": "€1"
      },
      "description": "The total amount is inclusive of all local duties, taxes and fees. We guarantee no additional charges on delivery.",
      "total": 16,
      "edd": {
        "min_days": 7,
        "max_days": 11,
        "message": "7-11 business days."
      },
      "duty_tax_breakdown": [
        {
          "sku": "TSHIRT123",
          "description": "Black T-Shirt",
          "duty": 6
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.