> ## 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

> Get a warehouse-owned carton by ID. Foreign, absent, deleted and voided IDs all return null.

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

**Store must have one of:** `WMS`

## Arguments

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

The opaque carton ID.

## Returns

**carton** `[Carton](/docs/api-reference/v3/reference/consolidations/carton)`

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

**fields**

**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.

## Example

```graphql theme={null}
query {
  carton(id: "...") {
    cartonNumber
    displayIdentifier
    id
  }
}
```


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