--- title: "Estimate Rates" method: POST path: "/v1/rates/estimate" tags: ["rates"] --- # Estimate Rates `POST /v1/rates/estimate` Get Rate Estimates ## Request body - EstimateRatesRequestBody - `from_country_code` string — A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1) - `from_postal_code` string — postal code - `from_city_locality` string — from postal code - `from_state_province` string — From state province - `to_country_code` string — A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1) - `to_postal_code` string — postal code - `to_city_locality` string — The city locality the package is being shipped to - `to_state_province` string — To state province - `weight` Weight — The weight of a package - `value` number, required — The weight, in the specified unit - `unit` 'pound' | 'ounce' | 'gram' | 'kilogram', required — The possible weight unit values - `dimensions` Dimensions — The dimensions of a package - `unit` 'inch' | 'centimeter', required — The dimension units that are supported by ShipEngine. - `length` number, required — The length of the package, in the specified unit - `width` number, required — The width of the package, in the specified unit - `height` number, required — The height of the package, in the specified unit - `confirmation` 'none' | 'delivery' | 'signature' | 'adult_signature' | 'direct_signature' | 'delivery_mailed' | 'verbal_confirmation' | 'delivery_code' | 'age_verification_16_plus' — The possible delivery confirmation values - `address_residential_indicator` 'unknown' | 'yes' | 'no' — Indicates whether an address is residential. - `ship_date` string, date-time — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time. ## Response `200` The request was a success. - RateEstimate[] — A rate estimate response body - `rate_type` 'check' | 'shipment', required — The possible rate type values - `carrier_id` string, required — A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc. - `shipping_amount` MonetaryValue, required — A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance. - `currency` string, required — The currencies that are supported by ShipEngine are the ones that specified by ISO 4217: https://www.iso.org/iso-4217-currency-codes.html - `amount` number, required — The monetary amount, in the specified currency. - `insurance_amount` MonetaryValue, required — A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance. - `currency` string, required — The currencies that are supported by ShipEngine are the ones that specified by ISO 4217: https://www.iso.org/iso-4217-currency-codes.html - `amount` number, required — The monetary amount, in the specified currency. - `confirmation_amount` MonetaryValue, required — A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance. - `currency` string, required — The currencies that are supported by ShipEngine are the ones that specified by ISO 4217: https://www.iso.org/iso-4217-currency-codes.html - `amount` number, required — The monetary amount, in the specified currency. - `other_amount` MonetaryValue, required — A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance. - `currency` string, required — The currencies that are supported by ShipEngine are the ones that specified by ISO 4217: https://www.iso.org/iso-4217-currency-codes.html - `amount` number, required — The monetary amount, in the specified currency. - `tax_amount` MonetaryValue — A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance. - `currency` string, required — The currencies that are supported by ShipEngine are the ones that specified by ISO 4217: https://www.iso.org/iso-4217-currency-codes.html - `amount` number, required — The monetary amount, in the specified currency. - `zone` integer, nullable, required — Certain carriers base [their rates](https://blog.stamps.com/2017/09/08/usps-postal-zones/) off of custom zones that vary depending upon the ship_to and ship_from location - `package_type` string, nullable, required — package type that this rate was estimated for - `delivery_days` integer, nullable — The number of days estimated for delivery, this will show the _actual_ delivery time if for example, the package gets shipped on a Friday - `guaranteed_service` boolean, required — Indicates if the rate is guaranteed. - `estimated_delivery_date` string, date-time — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date, but not a specific time. The value _may_ contain a time component, but it will be set to `00:00:00` UTC by ShipEngine. - `carrier_delivery_days` string — The carrier delivery days - `ship_date` string, date-time — ship date - `negotiated_rate` boolean, required — Indicates if the rates been negotiated - `service_type` string, required — service type - `service_code` string, required — service code for the rate - `trackable` boolean, required — Indicates if rate is trackable - `carrier_code` string, required — A [shipping carrier](https://www.shipengine.com/docs/carriers/setup/), such as `fedex`, `dhl_express`, `stamps_com`, etc. - `carrier_nickname` string, required — carrier nickname - `carrier_friendly_name` string, required — carrier friendly name - `validation_status` 'valid' | 'invalid' | 'has_warnings' | 'unknown', required — The possible validation status values - `warning_messages` string[], required — The warning messages - `error_messages` string[], required — The error messages - `rate_attributes` RateAttributes[] — Optional attributes that indicate the most profitable rates ## Other responses - `400` — The request contained errors. - `500` — An error occurred on ShipEngine's side. > This error will automatically be reported to our engineers. --- [API](https://skmtc.net/shipengine/apis/shipengine-api.md) · [All operations](https://skmtc.net/shipengine/apis/shipengine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipengine/shipengine-api/versions/6af91511d87e/schema)