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

# Carton

> An identified physical box operated by the authenticated warehouse. It can exist before assignment to a shipment.

**Required scopes:** [`inventory_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-inventory_read)

**availableDocuments** `[\[DocumentOption!\]!](/docs/api-reference/v3/reference/consolidations/document-option)` *required*

Documents supported by the carton's current shipment association. An unassigned carton has none.

**fields**

**formats** `[\[DocumentFormat!\]!](/docs/api-reference/v3/reference/consolidations/document-format)` *required*

Its supported representations.

**kind** `[DocumentKind!](/docs/api-reference/v3/reference/consolidations/document-kind)` *required*

The available document.

**cartonNumber** `Int!` *required*

The carton's numeric display reference. Use id for identity.

**dimensions** `[Dimensions](/docs/api-reference/v3/reference/catalog/dimensions)`

Measured carton dimensions.

**fields**

**height** `Float`

The height, in `unit`.

**length** `Float`

The length, in `unit`.

**unit** `[DimensionUnit!](/docs/api-reference/v3/reference/catalog/dimension-unit)` *required*

The unit all three measurements are expressed in.

**width** `Float`

The width, in `unit`.

**displayIdentifier** `String!` *required*

The saved display label, falling back to its numeric reference.

**id** `ID!` *required*

The permanent opaque carton ID.

**weight** `[Weight](/docs/api-reference/v3/reference/catalog/weight)`

Measured carton weight.

**fields**

**unit** `[WeightUnit!](/docs/api-reference/v3/reference/catalog/weight-unit)` *required*

The unit the value is expressed in.

**value** `Float!` *required*

The numeric magnitude of the weight.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.