---
title: "Retrieve a shipping rate"
method: GET
path: "/v1/shipping_rates/{shipping_rate_token}"
---

# Retrieve a shipping rate

`GET /v1/shipping_rates/{shipping_rate_token}`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/shipping_rates/{shipping_rate_token}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Returns the shipping rate object with the given ID.

## Path parameters

- `shipping_rate_token` string, required

## Query parameters

- `expand` string[]

## Request body `application/x-www-form-urlencoded`

- object

## Response `200`

Successful response.

- ShippingRate: Shipping rates describe the price of shipping presented to your customers and applied to a purchase. For more information, see [Charge for shipping](https://docs.stripe.com/payments/during-payment/charge-shipping).
  - `active` boolean, required: Whether the shipping rate can be used for new purchases. Defaults to `true`.
  - `created` integer, required: Time at which the object was created. Measured in seconds since the Unix epoch.
  - `delivery_estimate` ShippingRateDeliveryEstimate
    - `maximum` ShippingRateDeliveryEstimateBound
      - `unit` 'business_day' | 'day' | 'hour' | 'month' | 'week', required: A unit of time.
      - `value` integer, required: Must be greater than 0.
    - `minimum` ShippingRateDeliveryEstimateBound
      - `unit` 'business_day' | 'day' | 'hour' | 'month' | 'week', required: A unit of time.
      - `value` integer, required: Must be greater than 0.
  - `display_name` string, nullable: The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
  - `fixed_amount` ShippingRateFixedAmount
    - `amount` integer, required: A non-negative integer in cents representing how much to charge.
    - `currency` string, currency, required: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
    - `currency_options` object: Shipping rates defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies).
  - `id` string, required: Unique identifier for the object.
  - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
  - `metadata` object, required: Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
  - `object` 'shipping_rate', required: String representing the object's type. Objects of the same type share the same value.
  - `tax_behavior` 'exclusive' | 'inclusive' | 'unspecified', nullable: Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`.
  - `tax_code` union: A [tax code](https://docs.stripe.com/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
    - string
    - TaxCode: [Tax codes](https://stripe.com/docs/tax/tax-categories) classify goods and services for tax purposes.
      - `description` string, required: A detailed description of which types of products the tax code represents.
      - `id` string, required: Unique identifier for the object.
      - `name` string, required: A short name for the tax code.
      - `object` 'tax_code', required: String representing the object's type. Objects of the same type share the same value.
      - `requirements` TaxCodeRequirements
        - `performance_location` 'optional' | 'required', required: Describes whether a performance location is required for a successful tax calculation with a tax code.
  - `type` 'fixed_amount', required: The type of calculation to use on the shipping rate.

## Other responses

- `default`: Error response.

## Changes

> 56 revisions in range; 10 not diffed, 14 could not be searched.

- **2025-11-05** `c113b1939b8f`: 1 info
  - added the optional property `error/payment_intent/payment_method_options/anyOf[subschema #1: PaymentIntentPaymentMethodOptions]/card_present/anyOf[subschema #1: payment_method_options_card_present]/capture_method` to the response with the `default` status
- **2025-10-22** `7b8f614372ca`: 1 info
  - added the optional property `error/payment_intent/amount_details/anyOf[subschema #1: PaymentFlowsAmountDetails]/line_items/data/items/payment_method_options/anyOf[subschema #1: PaymentFlowsAmountDetailsResourceLineItemsListResourceLineItemResourcePaymentMethodOptions]/klarna/subscription_reference` to the response with the `default` status
- **2025-08-19** `cd1ebd88f70f`: 2 info
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/paynow/location` to the response with the `default` status
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/paynow/reader` to the response with the `default` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/stripe/apis/spec3/changes/v1/shipping_rates/:shipping_rate_token/get.md)

---

[API](https://skmtc.dev/stripe/apis/spec3.md) - [All operations](https://skmtc.dev/stripe/apis/spec3/llms.txt) - [OpenAPI document](https://skmtc.dev/stripe/apis/spec3/revisions/585b581504ae?raw)