replenishment_listOffers
List Subscribe & Save offers with eligibility, pricing, inventory, program config, and delivery forecasts.
readAmazon Seller (SP-API)sp.replenishment-2022-11-07
Amazon SP-API · listOffers · POST /replenishment/2022-11-07/offers/search Shows which products are eligible for Subscribe & Save plus per-offer config (discount funding, auto-enrollment, upcoming deliveries). Pass the filters as flat arguments; the server nests them under Amazon's filters and fills marketplaceId and programTypes.
Call it
In an AI client (MCP)
{
"name": "replenishment_listOffers",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/replenishment_listOffers \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
programTypes | object[] | omit — SUBSCRIBE_AND_SAVE, the only value, is sent for you. |
asins | object[] | Filter by ASIN list. maxItems 20. |
skus | object[] | Filter by SKU list (sellers only). maxItems 20. |
eligibilities | object[] | Filter by eligibility status (this is an ARRAY, not a single value). Allowed: ELIGIBLE | INELIGIBLE | SUSPENDED | REPLENISHMENT_ONLY_ORDERING. |
preferences | object | Preference filter {"autoEnrollment": [<...>]} (opted-in or opted-out offers). |
promotions | object | Discount-funding percentage filters, e.g. {"sellingPartnerFundedBaseDiscount": {"percentage": [5, 10]}} — any of the four discount keys the Body block lists, each {"percentage": [int,...]} maxItems 10. |
deliveriesConditions | object[] | Delivery-health filter list (next-30-day delivery conditions). |
sort | object | Optional {"order": ASC or DESC, "key": one of the sort keys the Body block lists}. |
pageSize | integer | Results per page → pagination.limit. 1-100; default 20. |
offset | integer | Pagination offset → pagination.offset. 0-9000; default 0. |
marketplaceId | string | optional Amazon marketplaceId; defaults to the store ref's marketplace. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.result.offers[]— per-offer data (sku, asin, marketplaceId, eligibility, offerProgramConfiguration.{preferences.autoEnrollment, promotions.*FundedBaseDiscount.percentage, enrollmentMethod (MANUAL|AUTOMATIC)}, programType, vendorCodes, price, priceCurrencyCode, inventory, stockRisk, deliveriesConditions[].{condition,next30DaysDeliveries}, subscriptions, fulfillmentNetworkIDType, forecastDeliveries.next15/30/60/90DaysDeliveries).data.result.pagination.totalResults— total matching offers (for paging).
Body (Amazon schema)
pagination*: {limit* (1–100), offset* (0–9000)}
filters*: {marketplaceId*, skus: [string] (1–20), asins: [string] (1–20), eligibilities, preferences: {autoEnrollment}, promotions: {sellingPartnerFundedBaseDiscount, sellingPartnerFundedTieredDiscount, amazonFundedBaseDiscount, amazonFundedTieredDiscount}, programTypes*: [SUBSCRIBE_AND_SAVE] (min 1), deliveriesConditions}
filters.eligibilities: [ELIGIBLE | INELIGIBLE | SUSPENDED | REPLENISHMENT_ONLY_ORDERING]
filters.preferences.autoEnrollment: [OPTED_IN | OPTED_OUT]
filters.deliveriesConditions: [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]
sort: {order*: ASC | DESC, key*}
sort.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