---
title: "List inbound plan boxes"
method: GET
path: "/api/v1/sp-api/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/boxes"
tags: ["SP-API FBA Shipments"]
---

# List inbound plan boxes

`GET /api/v1/sp-api/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/boxes`

## Request

- Base URL: `https://app.sellerassistant.app` (the document declares no server; this is the origin it was published from)
- URL: `https://app.sellerassistant.app/api/v1/sp-api/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/boxes`
- Auth: one of:
  - API key in query parameter `api_key`
  - API key in header `X-Api-Key`

Proxy to https://developer-docs.amazon.com/sp-api/reference/listinboundplanboxes. The limit is 60 requests per minute. Amazon seller account integration is required to make this request. You can do it [here](https://app.sellerassistant.app/integrations/seller-central).

## Response `200`

Successful response

- ListInboundPlanBoxesResponse
  - `boxes` Box[], required: A list of boxes in an inbound plan.
    - `packageId` string, required: Primary key to uniquely identify a Package (Box or Pallet).
    - `boxId` string, nullable: The ID provided by Amazon that identifies a given box. This ID is comprised of the external shipment ID and the index of the box.
    - `contentInformationSource` 'INTERACTIVE' | 'FEED' | 'NONE', nullable: Indication of how box content is meant to be provided.
    - `destinationRegion` Region
      - `countryCode` string, nullable: ISO 3166 standard alpha-2 country code.
      - `state` string, nullable: State.
      - `warehouseId` string, nullable: An identifier for a warehouse, such as a FC, IXD, upstream storage.
    - `dimensions` BoxDimensions
      - `height` number, float, required: The height of a package.
      - `length` number, float, required: The length of a package.
      - `unitOfMeasurement` string, required: Unit of linear measure.
      - `width` number, float, required: The width of a package.
    - `externalContainerIdentifier` string, nullable: The external identifier for this container / box.
    - `externalContainerIdentifierType` string, nullable: Type of the external identifier used. Can be: `AMAZON`, `SSCC`.
    - `items` ShipmentItem[], nullable: Items contained within the box.
      - `asin` string, required: The Amazon Standard Identification Number (ASIN) of the item.
      - `expiration` string, date, nullable: The expiration date of the MSKU in YYYY-MM-DD format.
      - `fnsku` string, required: A unique identifier assigned by Amazon to products stored in fulfillment centers.
      - `labelOwner` 'AMAZON' | 'SELLER' | 'NONE', required: Specifies who will label the items.
      - `manufacturingLotCode` string, nullable: Manufacturing lot code.
      - `msku` string, required: The merchant SKU identifier.
      - `prepInstructions` PrepInstruction[], required: Special preparations that are required for an item.
        - `fee` CurrencyValue
          - `amount` number, float, required: Decimal value of the currency.
          - `code` string, required: ISO 4217 standard of a currency code.
        - `prepOwner` 'AMAZON' | 'SELLER' | 'NONE', nullable: In some situations, special preparations are required for items and this field reflects the owner of the preparations.
        - `prepType` 'ITEM_LABELING' | 'ITEM_BUBBLEWRAP' | 'ITEM_POLYBAGGING' | 'ITEM_TAPING' | 'ITEM_BLACK_SHRINKWRAP' | 'ITEM_HANG_GARMENT' | 'ITEM_BOXING' | 'ITEM_SETCREAT' | 'ITEM_RMOVHANG' | 'ITEM_SUFFOSTK' | 'ITEM_CAP_SEALING' | 'ITEM_DEBUNDLE' | 'ITEM_SETSTK' | 'ITEM_SIOC' | 'ITEM_NO_PREP' | 'ADULT' | 'BABY' | 'TEXTILE' | 'HANGER' | 'FRAGILE' | 'LIQUID' | 'SHARP' | 'SMALL' | 'PERFORATED' | 'GRANULAR' | 'SET' | 'FC_PROVIDED' | 'UNKNOWN' | 'NONE', nullable: Type of preparation that should be done.
      - `quantity` integer, required: The number of the specified MSKU.
    - `quantity` integer, nullable: The number of containers where all other properties like weight or dimensions are identical.
    - `templateName` string, nullable: Template name of the box.
    - `weight` BoxWeight
      - `unit` string, required: Unit of the weight being measured.
      - `value` number, float, required: Value of a weight.
  - `pagination` object, nullable
    - `nextToken` string, nullable: When present, pass this string token in the next request to return the next response page.

## Other responses

- `402`: Payment Required - subscription expired or payment method required
- `403`: Access denied - insufficient permissions, invalid API key, or the API request limit is used up (`public_api_key_limit`)
- `422`: Business logic error - operation cannot be completed due to business rules
- `429`: Too many requests - rate limit exceeded
- `500`: Internal Error

---

[API](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api.md) · [All operations](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sellerassistant/apis/seller-assistant-public-api/revisions/5b3ecdbcadb6?raw)