---
title: "Estimate rates"
method: POST
path: "/v2/rates/estimate"
tags: ["rates"]
---

# Estimate rates

`POST /v2/rates/estimate`

<aside class="access" aria-label="Endpoint access">
      <table class="access__table">
        <thead>
          <tr>
            <th class="access__table-header">Products</th>
            <th class="access__table-header">Plans</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td class="access__table-cell access__product">
              <img class="access__logo" src="/static/logos/shipstation-api-logo.svg" alt="ShipStation API Logo" loading="lazy" decoding="async"/>
              <div class="access__sub">Formerly ShipEngine</div>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-free.md" class="access__plan">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Advanced</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Enterprise</a>
            </td>
          </tr>
          <tr>
            <td class="access__table-cell">
              <img class="access__logo" src="/static/logos/shipstation-logo.svg" alt="ShipStation Logo" loading="lazy" decoding="async"/>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Starter</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Standard</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Premium</a>
            </td>
          </tr>
        </tbody>
      </table>
      <footer class="access__footer">
        <a class="access__help" href="/apis/@shipstation-v2/docs/getting-started/products-and-plans.md">
          Learn about products and plans
          <img src="/static/icons/external-link.svg" alt="External Link Icon" style="width: 16px;" loading="lazy" decoding="async"/>
        </a>
      </footer>
    </aside>

Get Rate Estimates

## Request body

- union — A rate estimate request body
  - object
    - `carrier_id` string — A string that uniquely identifies a ShipStation resource, such as a carrier, label, shipment, etc.
    - `from_country_code` string, required — A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1)
    - `from_postal_code` string, required — postal code
    - `from_city_locality` string, required — from postal code
    - `from_state_province` string, required — From state province
    - `to_country_code` string, required — A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1)
    - `to_postal_code` string, required — postal code
    - `to_city_locality` string, required — The city locality the package is being shipped to
    - `to_state_province` string, required — To state province
    - `weight` Weigth, required — 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 ShipStation .
      - `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' | 'adult_signature_restricted_delivery' | '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, required — An [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string that represents a date and time.
  - object
    - `carrier_ids` SeId[] — Array of Carrier Ids
    - `from_country_code` string, required — A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1)
    - `from_postal_code` string, required — postal code
    - `from_city_locality` string, required — from postal code
    - `from_state_province` string, required — From state province
    - `to_country_code` string, required — A two-letter [ISO 3166-1 country code](https://en.wikipedia.org/wiki/ISO_3166-1)
    - `to_postal_code` string, required — postal code
    - `to_city_locality` string, required — The city locality the package is being shipped to
    - `to_state_province` string, required — To state province
    - `weight` Weigth, required — 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 ShipStation .
      - `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' | 'adult_signature_restricted_delivery' | '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, required — 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 ShipStation 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 ShipStation 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 ShipStation 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 ShipStation 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 ShipStation 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 ShipStation 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, 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, required — package type that this rate was estimated for
  - `delivery_days` integer — 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 ShipStation .
  - `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] , 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

## Other responses

- `400` — The request contained errors.
- `500` — The request was successful.

---

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