---
title: "Create a shipment quote"
method: POST
path: "/quotes"
tags: ["Quotes"]
---

# Create a shipment quote

`POST /quotes`

Creates a shipment quote with specified sender (origin), receiver (destination), product and services.


This method determines the **estimated** price for a shipment on Shipmondo's agreement


**Important**: This endpoint will only provide prices for Shipmondos agreement.
If you want to get price for your own agreement please refer to [Shipment Quote](/operations/shipments_quote_post) instead
.

## Request body

- CreateQuoteRequest
  - `product_code` string, required — Product code referring to which product should be quoted for.
  - `service_codes` string — Comma-separated string of service codes referring to which services should be quoted for.
  - `sender` QuoteSender, required — Sender address for which the shipment is quoted.
    - `address1` string, required
    - `address2` string — Second address line can be used for floor/room number, building name etc.
    - `zipcode` string, required
    - `city` string, required
    - `country_code` string, required
  - `receiver` QuoteReceiver, required — Receiver address for which the shipment is quoted.
    - `address1` string, required
    - `address2` string — Second address line can be used for floor/room number, building name etc.
    - `zipcode` string, required
    - `city` string, required
    - `country_code` string, required
  - `parcels` ParcelAdvanced[], required
    - `quantity` integer — Number of parcels of this kind. Maximum quantity depends on the product.
    - `weight` integer, required — Weight in grams per colli.
    - `length` integer — Length in cm
    - `width` integer — Width in cm
    - `height` integer — Height in cm
    - `volume` number — Volume in cubic metres
    - `running_metre` number — Running metre in metre
    - `description` string — Describes the contents of the parcel.
    - `packaging` string — Package type for the parcel. Must be a valid package type for the customer.
    - `stackable` boolean — Whether the parcel can be stacked.
    - `dangerous_goods` DangerousGood[]
      - `class` string — ADR class of the dangerous goods.
      - `un_number` string — UN number of the dangerous goods.
      - `net_weight` integer — Net weight in grams of the dangerous goods. Use either this or net_weight_kg.
      - `net_weight_kg` number — Net weight in kilograms of the dangerous goods. Use either this or net_weight.
      - `gross_weight` integer — Gross weight in grams of the dangerous goods. Use either this or gross_weight_kg.
      - `gross_weight_kg` number — gross weight in kilograms of the dangerous goods. Maximum 3 decimal places. Use either this or gross_weight.
      - `quantity` integer — Number of pieces of this kind of dangerous goods.
      - `packaging` string — Packaging the dangerous goods are contained in.
      - `description` string — Description of the dangerous goods.
      - `tunnel_restriction_code` string — Tunnel restriction code that applies to the dangerous goods.
      - `packing_group` string — Packing group that applies to the dangerous goods.
      - `environmentally_hazardous` boolean — Whether or not the dangerous goods are hazardous to the environment.
    - `declared_value` DeclaredValue, nullable — Value of the goods in the parcel. Used in terms of insurance for certain carriers.
      - `amount` number — Valued amount.
      - `currency_code` string — Currency code for the currency of the amount.
    - `attributes` DynamicAttribute[] — Attributes for the parcel. Used for additional information.
      - `name` string, required — Name of the attribute.
      - `value` string, required — Value of the attribute.

## Response `200`

Successful.

- CreateQuoteResponse
  - `carrier_code` string — Carrier code referring to the carrier of the product that is quoted for.
  - `description` string — Text to describe the quote, which can be used when presenting it.
  - `product_code` string — Product code referring to the product which is quoted for.
  - `service_codes` string — Comma-separated string of service codes referring to the services which are quoted for.
  - `price` number — Estimated price of the shipment, including VAT.
  - `price_before_vat` number — Estimated price of the shipment, excluding VAT.
  - `currency_code` string — Currency code of the price.

## Other responses

- `401` — Unauthorized.
- `404` — Resource not found.
- `422` — Invalid or not found parameter(s)

---

[API](https://skmtc.net/shipmondo/apis/shipmondo-api.md) · [All operations](https://skmtc.net/shipmondo/apis/shipmondo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipmondo/shipmondo-api/versions/dbe9a4ea0826/schema)