> For the complete documentation index, see [llms.txt](https://docs.digitalriver.com/commerce-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-shipping-options/getting-shipping-options.md).

# Getting shipping options

## Getting a shipping option by identifier

To [get a shipping option by identifier](https://docs.digitalriver.com/commerce-api-references/shopper-apis/cart/shipping-options#v1-shoppers-me-carts-active-shipping-options-shippingoptionsid), specify the shipping options identifier (`shippingOptionsId`) in the URI path.

{% tabs %}
{% tab title="cURL" %}

```http
curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/me/carts/active/shipping-options/{shippingOptionsId}' \
--header 'authorization: Basic ***\
...
```

{% endtab %}

{% tab title="200 OK response" %}

```json
{
  "shippingOptions": {
    "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/shipping-options",
    "shippingOption": [
      {
        "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/shipping-options/5858800",
        "description": "UPS",
        "formattedCost": "19.99USD",
        "applyShippingOptionToCart": {
          "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/apply-shipping-option?shippingOptionId=5858800"
        }
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}

See the [query parameters](https://docs.digitalriver.com/commerce-api-references/shopper-apis/cart/shipping-options#v1-shoppers-me-carts-active-shipping-options-shippingoptionsid) for more information.

## Getting all shipping options

You can also [get all shipping options](https://docs.digitalriver.com/commerce-api-references/shopper-apis/cart/shipping-options#v1-shoppers-me-carts-active-shipping-options).

{% tabs %}
{% tab title="cURL" %}

```http
curl --location --request GET 'https://api.digitalriver.com/v1/shoppers/me/carts/active/shipping-options' \
--header 'authorization: Basic ***\
...
```

{% endtab %}

{% tab title="200 OK response" %}

```json
{
  "shippingOption": {
    "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/shipping-options/142400",
    "id": 142400,
    "description": "UPS Ground",
    "cost": {
      "currency": "USD",
      "value": "19.99"
    },
    "formattedCost": "19.99USD",
    "applyShippingOptionToCart": {
      "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/apply-shipping-option?shippingOptionId=142400"
    }
  }
}
```

{% endtab %}
{% endtabs %}

See the [query parameters](https://docs.digitalriver.com/commerce-api-references/shopper-apis/cart/shipping-options#v1-shoppers-me-carts-active-shipping-options) for more information.

## Shipping options

You can retrieve the [shipping options for a cart](https://docs.digitalriver.com/commerce-api-references/shopper-apis/cart/shipping-options#v1-shoppers-me-carts-active-shipping-options-shippingoptionsid) or [all shipping options](https://docs.digitalriver.com/commerce-api-references/shopper-apis/cart/shipping-options#v1-shoppers-me-carts-active-shipping-options). The `shippingOptions` object in the response retrieves the discounted shipping rate based on the matching deployed [shipping discount offer](/commerce-api/shopper-apis/cart/managing-shipping-options/providing-a-shipping-discount.md#creating-a-shipping-discount-offer). A successful request returns the `costWithDiscount` and `formattedCostWithDiscount` .

<table><thead><tr><th width="323">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><code>costWithDiscount</code></td><td>The sum of the shipping cost with discounts.</td></tr><tr><td><code>formattedCostWithDiscount</code></td><td>The sum of the shipping cost with a discount in locale currency format (for example, $ 19.14). Contact your Digital River team to set up the currency symbol, decimal separator, and number of fractional digits for the formatted cost with discount amount.</td></tr></tbody></table>

{% tabs %}
{% tab title="JSON" %}

```json
{
    "shippingOption": {
        "uri": "http://api.digitalriver.com/v1/shoppers/me/carts/active/shipping-options/167400",
        "id": 167400,
        "description": "Express",
        "cost": {
            "currency": "USD",
            "value": 12.5
        },
        "formattedCost": "12.50USD",
        "costWithDiscount": {
            "currency": "USD",
            "value": 10.87
        },
        "formattedCostWithDiscount": "10.87USD",
        "applyShippingOptionToCart": {
            "uri": "http://api.digitalriver.com/v1/shoppers/me/carts/active/apply-shipping-option?shippingOptionId=167400"
        }
    }
}
```

{% endtab %}
{% endtabs %}