---
title: "Get a pricing quote"
method: POST
path: "/client/shipments/quote"
tags: ["Shipments"]
---

# Get a pricing quote

`POST /client/shipments/quote`

Returns estimated shipping rates for a given destination address, package dimensions, weight, and postage type. Does not create a shipment, reserve a rate, charge the merchant, or guarantee final service availability.

## Request body

- PricingQuoteRequest
  - `address` Address, required
    - `address1` string, required — Address line 1.
    - `address2` string — Address line 2.
    - `address3` string — Address line 3.
    - `city` string, required — City.
    - `province` string, required — Province or state code.
    - `postalCode` string, required — Postal or ZIP code.
    - `country` string, required — Country code (e.g. CA, US).
    - `latitude` number — Latitude.
    - `longitude` number — Longitude.
  - `dimensions` Dimensions
    - `length` number — Length.
    - `width` number — Width.
    - `height` number — Height.
    - `dimensionUnit` 'CM' | 'INCH' | 'M' | 'FT' — Unit of dimension.
  - `packagingId` number — ID of a pre-configured packaging profile. Use instead of dimensions if the package matches a saved profile.
  - `weight` Weight, required
    - `value` number, required — Weight value.
    - `weightUnit` 'G' | 'KG' | 'LB' | 'OZ', required — Unit of weight.
  - `postageType` 'STANDARD' | 'USPS Ground Advantage' | 'PostNL International Packet Tracked', required — Requested postage service. STANDARD is for domestic. USPS Ground Advantage is for CA to US cross-border (DDP, merchant pays duties). PostNL International Packet Tracked is for CA to US cross-border (DDU, recipient pays duties). If the requested type is unavailable, an available type is selected automatically.

## Response `200`

Estimated rates retrieved successfully

- object
  - `message` string, required
  - `code` integer, required — Status code. 0 indicates success.
  - `data` PricingQuoteResponseData
    - `rates` Rate[], required — List of estimated rates. May be empty if no service is available for the given inputs.
      - `postageType` string, required
      - `carrierName` string, required
      - `postageFee` number, required
      - `tax` number, required
      - `total` number, required
      - `currency` string, required — Always returned as CAD, including cross-border CA to US routes.
      - `estimated` boolean, required
      - `minDeliveryDays` number, required
      - `maxDeliveryDays` number, required
    - `carrierName` string, required
    - `estimated` boolean, required
    - `disclaimer` string, required

---

[API](https://skmtc.dev/uniuni/apis/uniuni-platform-client-api.md) · [All operations](https://skmtc.dev/uniuni/apis/uniuni-platform-client-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uniuni/uniuni-platform-client-api/revisions/d61334c7f8b1/schema)