> ## Documentation Index
> Fetch the complete documentation index at: https://dev.puppetvendors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Shipping Dimensions

> Retrieve saved shipping dimension presets

<Note>
  **V2 Preview** — This endpoint is part of the V2 API preview. Breaking changes may occur.
</Note>

## Overview

Retrieve saved shipping dimension presets for the vendor. Dimensions can be generic (reusable across products) or product-specific. These presets pre-fill package dimensions when fetching shipping rates.

### Use Cases

* List available dimension presets for a rate-fetch UI
* Filter product-specific dimensions for a particular product
* Audit saved dimension configurations

## Query Parameters

<ParamField query="type" type="string">
  Filter by dimension type. Must be `generic` or `productSpecific`.
</ParamField>

<ParamField query="productId" type="string">
  Filter by Shopify product ID. Typically used with `type=productSpecific`.
</ParamField>

<ParamField query="title" type="string">
  Filter by dimension preset title.
</ParamField>

## Response

```json 200 theme={null}
{
  "success": true,
  "data": [
    {
      "_id": "665a1b2e3d98f0001a2b3c50",
      "type": "generic",
      "title": "Small Box",
      "dimensionUnit": "in",
      "heightValue": 4,
      "widthValue": 6,
      "lengthValue": 8
    },
    {
      "_id": "665a1b2e3d98f0001a2b3c51",
      "type": "productSpecific",
      "productId": "7890123456",
      "title": "Widget Packaging",
      "dimensionUnit": "cm",
      "heightValue": 10,
      "widthValue": 15,
      "lengthValue": 20
    }
  ]
}
```

## Example

```bash theme={null}
curl -X GET "https://staging-api.puppetvendors.com/shipping/dimensions?type=generic" \
  -H "x-access-token: YOUR_VENDOR_TOKEN"
```