---
title: "List Shipping Rates"
method: GET
path: "/v1/shipping_rates"
tags: ["Shipping Rates"]
---

# List Shipping Rates

`GET /v1/shipping_rates`

Returns a list of your shipping rates, most recent first. Pass `active` to return only active
or only archived rates.

## Query parameters

- `active` boolean, nullable — Only return shipping rates where `active` matches this value.
- `limit` integer, nullable — A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
- `offset` integer, nullable — Number of objects to skip before returning results.
- `starting_after` string, nullable — A cursor for use in pagination. `starting_after` is a shipping rate ID that defines your place in the list.
- `ending_before` string, nullable — A cursor for use in pagination. `ending_before` is a shipping rate ID that defines your place in the list.

## Response `200`

An envelope wrapping a list of shipping rate objects.

- MultipleShippingRatesBodyForV1ShippingRate — An envelope wrapping a list of shipping rate objects.
  - `shipping_rates` V1ShippingRate[], required — The list of shipping rates.
    - `shipping_rate_id` string, required — Unique identifier for the shipping rate.
    - `active` boolean, required — Whether the shipping rate can be applied to new checkout sessions. Defaults to `true` on creation; set to `false` to archive it.
    - `display_name` string, required — The name shown to the customer at checkout (e.g., `Standard Shipping`).
    - `amount` integer, required — The shipping cost, in the smallest currency unit (e.g., `500` = $5.00 USD). Always in USD.
    - `metadata` object, nullable — Set of key-value pairs you can attach to the shipping rate for storing additional structured information. Omitted when no metadata is set.
    - `created_at` string, required — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

---

[API](https://skmtc.dev/withflex/apis/flex-api.md) · [All operations](https://skmtc.dev/withflex/apis/flex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withflex/flex-api/revisions/b1560fc2f199/schema)