---
title: "List all shipping rates"
method: GET
path: "/v1/shipping_rates"
---

# List all shipping rates

`GET /v1/shipping_rates`

Returns a list of your shipping rates.

## Query parameters

- `active` boolean
- `created` union
  - object
    - `gt` integer
    - `gte` integer
    - `lt` integer
    - `lte` integer
  - integer
- `currency` string, currency
- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string

## Response `200`

Successful response.

- object
  - `data` ShippingRate[], required
    - `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.
    - `type` 'fixed_amount', required — The type of calculation to use on the shipping rate.
  - `has_more` boolean, required — True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required — String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required — The URL where this list can be accessed.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stripe/apis/spec3.md) · [All operations](https://skmtc.net/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/3653ad45bbec/schema)