> ## Documentation Index
> Fetch the complete documentation index at: https://help.ship.uniuni.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener una cotización de precio

> 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.



## OpenAPI

````yaml POST /client/shipments/quote
openapi: 3.1.0
info:
  title: UniUni Platform Client API
  description: >-
    API for creating shipments, purchasing labels, managing batches, tracking
    deliveries, and receiving webhook notifications.
  version: 1.0.0
  contact:
    name: UniUni Retail Support
    email: retailsupport@uniuni.com
servers:
  - url: https://api.ship.uniuni.com/prod
    description: Production
  - url: https://api-sandbox.ship.uniuni.com
    description: Sandbox
security:
  - bearerAuth: []
tags:
  - name: Shipments
    description: Create, retrieve, list, purchase, refund, and delete shipments.
  - name: Batches
    description: Group purchased shipments into batches for drop-off or pickup.
  - name: Labels
    description: Retrieve shipping and batch labels as Base64-encoded PDFs.
  - name: Tracking
    description: Track shipment status and scan events.
  - name: Webhooks
    description: Receive real-time shipment status updates.
paths:
  /client/shipments/quote:
    post:
      tags:
        - Shipments
      summary: Get a pricing quote
      description: >-
        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.
      operationId: getPricingQuote
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PricingQuoteRequest'
      responses:
        '200':
          description: Estimated rates retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  code:
                    type: integer
                    description: Status code. 0 indicates success.
                  data:
                    $ref: '#/components/schemas/PricingQuoteResponseData'
                required:
                  - message
                  - code
              examples:
                success:
                  summary: Estimated rates retrieved successfully
                  value:
                    message: Estimated rates retrieved successfully
                    code: 0
                    data:
                      rates:
                        - postageType: NEXT DAY
                          carrierName: UniUni
                          postageFee: 1.3
                          tax: 0
                          total: 1.3
                          currency: CAD
                          estimated: true
                          minDeliveryDays: 1
                          maxDeliveryDays: 2
                      carrierName: UniUni
                      estimated: true
                      disclaimer: >-
                        Rates are estimates only and do not guarantee final
                        shipment eligibility, service availability, or delivery.
                noRates:
                  summary: No rates available
                  value:
                    message: Estimated rates retrieved successfully
                    code: 0
                    data:
                      rates: []
                      carrierName: UniUni
                      estimated: true
                      disclaimer: >-
                        Rates are estimates only and do not guarantee final
                        shipment eligibility, service availability, or delivery.
                failure:
                  summary: Invalid input
                  value:
                    message: country CountryDoesNotExist not valid
                    code: 1009
                    data: null
components:
  schemas:
    PricingQuoteRequest:
      type: object
      properties:
        address:
          $ref: '#/components/schemas/Address'
        dimensions:
          $ref: '#/components/schemas/Dimensions'
          description: >-
            Package dimensions. Provide either dimensions or packagingId, not
            both. If neither is provided, a saved default packaging preset will
            be used. If there are no saved packaging presets, dimensions are
            required.
        packagingId:
          type: number
          description: >-
            ID of a pre-configured packaging profile. Use instead of dimensions
            if the package matches a saved profile.
        weight:
          $ref: '#/components/schemas/Weight'
        postageType:
          type: string
          enum:
            - STANDARD
            - USPS Ground Advantage
            - PostNL International Packet Tracked
          description: >-
            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.
      required:
        - address
        - weight
        - postageType
    PricingQuoteResponseData:
      type: object
      properties:
        rates:
          type: array
          items:
            $ref: '#/components/schemas/Rate'
          description: >-
            List of estimated rates. May be empty if no service is available for
            the given inputs.
        carrierName:
          type: string
        estimated:
          type: boolean
        disclaimer:
          type: string
      required:
        - rates
        - carrierName
        - estimated
        - disclaimer
    Address:
      type: object
      properties:
        address1:
          type: string
          description: Address line 1.
        address2:
          type: string
          description: Address line 2.
        address3:
          type: string
          description: Address line 3.
        city:
          type: string
          description: City.
        province:
          type: string
          description: Province or state code.
        postalCode:
          type: string
          description: Postal or ZIP code.
        country:
          type: string
          description: Country code (e.g. CA, US).
        latitude:
          type: number
          description: Latitude.
        longitude:
          type: number
          description: Longitude.
      required:
        - address1
        - city
        - province
        - postalCode
        - country
    Dimensions:
      type: object
      properties:
        length:
          type: number
          description: Length.
        width:
          type: number
          description: Width.
        height:
          type: number
          description: Height.
        dimensionUnit:
          type: string
          enum:
            - CM
            - INCH
            - M
            - FT
          description: Unit of dimension.
    Weight:
      type: object
      properties:
        value:
          type: number
          description: Weight value.
        weightUnit:
          type: string
          enum:
            - G
            - KG
            - LB
            - OZ
          description: Unit of weight.
      required:
        - value
        - weightUnit
    Rate:
      type: object
      properties:
        postageType:
          type: string
        carrierName:
          type: string
        postageFee:
          type: number
        tax:
          type: number
        total:
          type: number
        currency:
          type: string
          description: Always returned as CAD, including cross-border CA to US routes.
        estimated:
          type: boolean
        minDeliveryDays:
          type: number
        maxDeliveryDays:
          type: number
      required:
        - postageType
        - carrierName
        - postageFee
        - tax
        - total
        - currency
        - estimated
        - minDeliveryDays
        - maxDeliveryDays
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API access token generated from the UniUni Platform dashboard.

````