--- title: "listOffers" method: POST path: "/replenishment/2022-11-07/offers/search" tags: ["Replenishment v2022-11-07"] --- # listOffers `POST /replenishment/2022-11-07/offers/search` Returns the details of a selling partner's replenishment program offers. **Usage Plan:** | Rate (requests per second) | Burst | | ---- | ---- | | 1 | 1 | The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api). ## Request body - ListOffersRequest — The request body for the `listOffers` operation. - `pagination` ListOffersRequestPagination, required — Use these parameters to paginate through the response. - `limit` integer, required — The maximum number of results to return in the response. - `offset` integer, required — The offset from which to retrieve the number of results specified by the `limit` value. The first result is at offset 0. - `filters` ListOffersRequestFilters, required — Use these parameters to filter results. Any result must match all provided parameters. For parameters that accept multiple values (arrays), the API returns results that match at least one value in the array. - `marketplaceId` string, required — The identifier of the Amazon marketplace. For the list of all marketplace IDs, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids). - `skus` string[] — A list of SKUs to filter. This filter is only supported for sellers and not for vendors. - `asins` string[] — A list of Amazon Standard Identification Numbers (ASINs). - `eligibilities` EligibilityStatus[] — A list of eligibilities associated with an offer. - `preferences` Preference — Offer preferences that you can include in the result filter criteria. - `autoEnrollment` AutoEnrollmentPreference[] — Filters the results to only include offers with the auto-enrollment preference specified. - `promotions` Promotion — Offer promotions to include in the result filter criteria. - `sellingPartnerFundedBaseDiscount` DiscountFunding — The discount funding on the offer. - `percentage` number[] — Filters the results to only include offers with the percentage specified. - `sellingPartnerFundedTieredDiscount` DiscountFunding — The discount funding on the offer. - `percentage` number[] — Filters the results to only include offers with the percentage specified. - `amazonFundedBaseDiscount` DiscountFunding — The discount funding on the offer. - `percentage` number[] — Filters the results to only include offers with the percentage specified. - `amazonFundedTieredDiscount` DiscountFunding — The discount funding on the offer. - `percentage` number[] — Filters the results to only include offers with the percentage specified. - `programTypes` ProgramType[], required — A list of replenishment program types. - `deliveriesConditions` string[] — A list of delivery condition types to filter the results by. Results are filtered to only include offers with the specified delivery conditions. - `sort` ListOffersRequestSort — Use these parameters to sort the response. - `order` 'ASC' | 'DESC', required — The sort order. - `key` 'ASIN' | 'SELLING_PARTNER_FUNDED_BASE_DISCOUNT_PERCENTAGE' | 'SELLING_PARTNER_FUNDED_TIERED_DISCOUNT_PERCENTAGE' | 'AMAZON_FUNDED_BASE_DISCOUNT_PERCENTAGE' | 'AMAZON_FUNDED_TIERED_DISCOUNT_PERCENTAGE' | 'INVENTORY' | 'PRICE' | 'SUBSCRIPTION_COUNT' | 'FULFILLMENT_NETWORK_ID_TYPE', required — The attribute to use to sort the results. ## Response `200` Success. - ListOffersResponse — The response schema for the `listOffers` operation. - `offers` ListOffersResponseOffer[] — A list of offers. - `sku` string — The SKU. This property is only supported for sellers and not for vendors. - `asin` string — The Amazon Standard Identification Number (ASIN). - `marketplaceId` string — The identifier of the Amazon marketplace. For the list of all marketplace IDs, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids). - `eligibility` 'ELIGIBLE' | 'INELIGIBLE' | 'SUSPENDED' | 'REPLENISHMENT_ONLY_ORDERING' — The current eligibility status of an offer. - `offerProgramConfiguration` OfferProgramConfiguration — The offer program configuration contains a set of program properties for an offer. - `preferences` OfferProgramConfigurationPreferences — An object which contains the preferences applied to the offer. - `autoEnrollment` 'OPTED_IN' | 'OPTED_OUT' — The auto-enrollment preference indicates whether the offer is opted-in to or opted-out of Amazon's auto-enrollment feature. - `promotions` OfferProgramConfigurationPromotions — An object which represents all promotions applied to an offer. - `sellingPartnerFundedBaseDiscount` OfferProgramConfigurationPromotionsDiscountFunding — A promotional percentage discount applied to the offer. - `percentage` number — The percentage discount on the offer. - `sellingPartnerFundedTieredDiscount` OfferProgramConfigurationPromotionsDiscountFunding — A promotional percentage discount applied to the offer. - `percentage` number — The percentage discount on the offer. - `amazonFundedBaseDiscount` OfferProgramConfigurationPromotionsDiscountFunding — A promotional percentage discount applied to the offer. - `percentage` number — The percentage discount on the offer. - `amazonFundedTieredDiscount` OfferProgramConfigurationPromotionsDiscountFunding — A promotional percentage discount applied to the offer. - `percentage` number — The percentage discount on the offer. - `enrollmentMethod` 'MANUAL' | 'AUTOMATIC' — The enrollment method used to enroll the offer into the program. - `programType` 'SUBSCRIBE_AND_SAVE' — The replenishment program type. - `vendorCodes` string[] — A list of vendor codes associated with the offer. - `price` number, double — The current price of the offer. This is the listed price amount for the item. - `priceCurrencyCode` string — The currency code in ISO 4217 format for the price. For example, `USD` for US dollars. - `inventory` integer — The available inventory count for the offer. - `stockRisk` string — The stock risk level of the offer, indicating the risk of the offer going out of stock. - `deliveriesConditions` DeliveriesCondition[] — A list of delivery conditions for the offer, indicating the health of upcoming deliveries. Each condition describes the quantity of upcoming deliveries associated with a particular delivery condition type. - `condition` 'NEXT_30_DAYS_DELIVERIES_PAUSED_PRICING' | 'NEXT_30_DAYS_DELIVERIES_PAUSED_NON_BUYABLE' | 'NEXT_30_DAYS_DELIVERIES_AT_LOW_INVENTORY_RISK_ONLY' | 'NEXT_30_DAYS_DELIVERIES_AT_LOW_INVENTORY_RISK' | 'NO_ISSUES_FOR_NEXT_30_DAYS_DELIVERIES' — The condition type of upcoming deliveries for the offer. - `next30DaysDeliveries` integer — The number of upcoming deliveries in the next 30 days associated with this delivery condition. - `subscriptions` integer — The number of active subscriptions for the offer. - `fulfillmentNetworkIDType` string — The fulfillment network identifier type for the offer, indicating how the offer is fulfilled. - `forecastDeliveries` ForecastDeliveries — An object which contains the projected subscriber demand for the offer over different time horizons. - `next15DaysDeliveries` integer — The projected number of subscriber deliveries in the next 15 days. - `next30DaysDeliveries` integer — The projected number of subscriber deliveries in the next 30 days. - `next60DaysDeliveries` integer — The projected number of subscriber deliveries in the next 60 days. - `next90DaysDeliveries` integer — The projected number of subscriber deliveries in the next 90 days. - `pagination` PaginationResponse — Use these parameters to paginate through the response. - `totalResults` integer — Total number of results matching the given filter criteria. ## Other responses - `400` — Request has missing or invalid parameters and cannot be parsed. - `401` — The request's Authorization header is not formatted correctly or does not contain a valid token. - `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature. - `404` — The specified resource 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)