---
title: "Get a dimension profile"
method: GET
path: "/shipping/dimension_profiles/{dimension_profile_id}"
tags: ["Shipping"]
---

# Get a dimension profile

`GET /shipping/dimension_profiles/{dimension_profile_id}`

## Request

- Base URL: `https://api.whatnot.com/seller-api/rest/v2`
- URL: `https://api.whatnot.com/seller-api/rest/v2/shipping/dimension_profiles/{dimension_profile_id}`
- 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`

Retrieve a dimension profile owned by the authenticated seller or provided by Whatnot, including inactive profiles. Requires read:inventory.

## Path parameters

- `dimension_profile_id` string, required

## Response `200`

Successful Response

- DimensionProfile: A dimension profile, also embedded in products and shipment items. On read, the resolved profile. On create, reference an existing profile by `id`, or supply `weight` and `dimensions` (with an optional `name`) to auto-create one.
  - `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.

## Other responses

- `404`: Dimension profile not found.
- `422`: Validation Error

---

[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/e619f15f7ce0?raw)
