---
title: "listPlacementOptions"
method: GET
path: "/inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions"
tags: ["Fulfillment Inbound v2024-03-20"]
---

# listPlacementOptions

`GET /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/placementOptions`

Provides a list of all placement options for an inbound plan. Placement options must first be generated by the corresponding operation before becoming available.

## Path parameters

- `inboundPlanId` string, required

## Query parameters

- `pageSize` integer
- `paginationToken` string

## Response `200`

ListPlacementOptions 200 response

- ListPlacementOptionsResponse — The `listPlacementOptions` response.
  - `pagination` Pagination — The pagination elements required to retrieve the remaining data.
    - `nextToken` string — A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to the next request. If NextToken is not returned, there are no more shipment items to return.
  - `placementOptions` PlacementOption[], required — Placement options generated for the inbound plan.
    - `discounts` Incentive[], required — Discount for the offered option.
      - `description` string, required — Description of the incentive.
      - `target` string, required — Target of the incentive. Possible values: 'Placement Services', 'Fulfillment Fee Discount'.
      - `type` string, required — Type of incentive. Possible values: `FEE`, `DISCOUNT`.
      - `value` Currency, required — A currency type and amount.
        - `currencyCode` string — The three-digit currency code in ISO 4217 format.
        - `currencyAmount` number — A decimal number, such as an amount or FX rate.
    - `expiration` string, date-time — The expiration date of the placement option. In [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) datetime format with pattern `yyyy-MM-ddTHH:mm:ss.sssZ`.
    - `fees` Incentive[], required — The fee for the offered option.
      - `description` string, required — Description of the incentive.
      - `target` string, required — Target of the incentive. Possible values: 'Placement Services', 'Fulfillment Fee Discount'.
      - `type` string, required — Type of incentive. Possible values: `FEE`, `DISCOUNT`.
      - `value` Currency, required — A currency type and amount.
        - `currencyCode` string — The three-digit currency code in ISO 4217 format.
        - `currencyAmount` number — A decimal number, such as an amount or FX rate.
    - `placementOptionId` string, required — The identifier of a placement option. A placement option represents the shipment splits and destinations of SKUs.
    - `shipmentIds` string[], required — Shipment ids.
    - `status` string, required — The status of a placement option. Possible values: `OFFERED`, `ACCEPTED`, `EXPIRED`.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)