---
title: "Get shipping rates"
method: POST
path: "/shipments/getrates"
tags: ["shipments"]
---

# Get shipping rates

`POST /shipments/getrates`

Retrieves shipping rates for the specified shipping details. Use this endpoint to compare rates across different carriers and services before creating a label.

## Request body

- object
  - `carrierCode` string, required — Carrier code to get rates from
  - `serviceCode` string, nullable — Specific service code (optional)
  - `packageCode` string, nullable — Package type code (optional)
  - `fromPostalCode` string, required — Origin postal code
  - `toCountry` string, required — Destination country (two-letter ISO code)
  - `toPostalCode` string, required — Destination postal code
  - `toState` string — Destination state (required for UPS)
  - `toCity` string — Destination city (optional)
  - `weight` Weight, required — Weight measurement
    - `value` number, required — Weight value
    - `units` 'pounds' | 'ounces' | 'grams', required — Weight unit of measurement
  - `dimensions` Dimensions — Package dimensions
    - `length` number, required — Length
    - `width` number, required — Width
    - `height` number, required — Height
    - `units` 'inches' | 'centimeters', required — Dimension unit of measurement
  - `confirmation` 'none' | 'delivery' | 'signature' | 'adult_signature' | 'direct_signature' — Delivery confirmation type
  - `residential` boolean — Whether destination is residential

## Response `200`

List of available shipping rates

- object[]
  - `serviceName` string
  - `serviceCode` string
  - `shipmentCost` number
  - `otherCost` number

## Other responses

- `400` — Bad Request - The request could not be understood or was missing required parameters
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `500` — Internal Server Error - An error occurred on the server

---

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