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

# List placement options

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

## 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}/placementOptions`
- 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/listplacementoptions. 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

- ListPlacementOptionsResponse
  - `pagination` object, nullable
    - `nextToken` string, nullable: When present, pass this string token in the next request to return the next response page.
  - `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` 'Placement Services' | 'Fulfillment Fee Discount', required: Target of the incentive.
      - `type` 'FEE' | 'DISCOUNT', required: Type of incentive.
      - `value` CurrencyValue, required
        - `amount` number, float, required: Decimal value of the currency.
        - `code` string, required: ISO 4217 standard of a currency code.
    - `expiration` string, date-time, nullable: The expiration date of the placement option.
    - `fees` Incentive[], required: The fee for the offered option.
      - `description` string, required: Description of the incentive.
      - `target` 'Placement Services' | 'Fulfillment Fee Discount', required: Target of the incentive.
      - `type` 'FEE' | 'DISCOUNT', required: Type of incentive.
      - `value` CurrencyValue, required
        - `amount` number, float, required: Decimal value of the currency.
        - `code` string, required: ISO 4217 standard of a currency code.
    - `placementOptionId` string, required: The identifier of a placement option.
    - `shipmentIds` string[], required: Shipment ids.
    - `status` 'OFFERED' | 'ACCEPTED' | 'EXPIRED', required: The status of a placement option.

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