---
title: "List dimension profiles"
method: GET
path: "/shipping/dimension_profiles"
tags: ["Shipping"]
---

# List dimension profiles

`GET /shipping/dimension_profiles`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/shipping/dimension_profiles`
- Auth: OAuth 2
  - Authorization code: `https://api.whatnot.com/seller-api/rest/oauth/authorize`
  - Token URL: `https://api.whatnot.com/seller-api/rest/oauth/token`

List the seller's own active dimension profiles newest first by default; set reverse=false for oldest first. Requires read:inventory.

## Query parameters

- `limit` integer: Maximum results per page.
- `cursor` string, nullable: Cursor from the previous page.
- `reverse` boolean: Return descending order when true; ascending when false.

## Response `200`

Successful Response

- PageResponseDimensionProfile
  - `data` DimensionProfile[], required: Results in the requested order.
    - `id` string, nullable: An existing dimension profile id to reference.
    - `name` string, nullable: The dimension profile's name. When auto-creating a profile this is used as a name prefix, with the weight and dimensions appended.
    - `weight` Weight
      - `value` number, required: The weight amount.
      - `unit` 'ounce' | 'pound' | 'gram' | 'kilogram', required: The unit used to express weight.
    - `dimensions` Dimensions
      - `length` number, required: The package length.
      - `width` number, required: The package width.
      - `height` number, required: The package height.
      - `unit` 'inch' | 'feet' | 'centimeter' | 'meter', required
    - `ownership` 'seller' | 'whatnot'
    - `active` boolean, nullable: Whether the dimension profile is active.
  - `next_cursor` string, nullable, required: Continuation cursor; null when there are no more results.

## Other responses

- `422`: Invalid limit, cursor, or reverse flag.

---

[API](https://skmtc.dev/whatnot/apis/whatnot-seller-api.md) - [All operations](https://skmtc.dev/whatnot/apis/whatnot-seller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whatnot/apis/whatnot-seller-api/revisions/c274ab93abf2?raw)