--- title: "POST /send_offer_to_interested_buyers" method: POST path: "/send_offer_to_interested_buyers" tags: ["offer"] --- # POST /send_offer_to_interested_buyers `POST /send_offer_to_interested_buyers` This method sends eligible buyers offers to purchase items in a listing at a discount. When a buyer has shown interest in a listing, they become "eligible" to receive a seller-initiated offer to purchase the item(s). Sellers use findEligibleItems to get the set of listings that have interested buyers. If a listing has interested buyers, sellers can use this method (sendOfferToInterestedBuyers) to send an offer to the buyers who are interested in the listing. The offer gives buyers the ability to purchase the associated listings at a discounted price. For details about how to create seller offers to buyers, see Sending offers to buyers. ## Headers - `X-EBAY-C-MARKETPLACE-ID` string, required ## Request body - CreateOffersRequest — This complex type contains the fields needed to create an offer to a buyer that is initiated by the seller. - `allowCounterOffer` boolean — If set to true, the buyer is allowed to make a counter-offer to the seller's offer. Note: Currently, you must set this field to false; counter-offers are not supported in this release. Default: false - `message` string — A seller-defined message related to the offer being made. This message is sent to the list of "interested" buyers. To increase the conversion rate of the offers a seller makes to buyers, eBay recommends you always add a customized message to your offers. Maximum length: 2,000 characters - `offerDuration` TimeDuration — A complex type that specifies a period of time using a specified time-measurement unit. - `unit` string — A time-measurement unit that specifies a singular period of time. A span of time is defined when you apply the value specified in the value field to the value specified for unit. Time-measurement units can be YEAR, MONTH, DAY, and so on. See TimeDurationUnitEnum for a complete list of possible time-measurement units. For implementation help, refer to eBay API documentation - `value` integer — An integer that represents an amount of time, as measured by the time-measurement unit specified in the unit field. - `offeredItems` OfferedItem[] — An array of objects where each object contains the details of an offer and the ID of the listing on which the offer is being made. Note that the service does not currently support the creation of multiple offers with a single call to sendOfferToInterestedBuyer. With this, each request can target only one listing at a time and you must populate this array with a single element that contains the details of one offer. - `discountPercentage` string — This value denotes the percentage that the listing in the offer will be discounted from its original listed price. The seller can specify either the exact price of the discounted items with the price field or they can use this field to specify the percentage that the listing will be discounted, but not both. Minimum: 5 Required if you do not specify a price value. - `listingId` string — This value is a unique eBay-assigned ID that identifies the listing to which the offer pertains. A listingId value is generated by eBay when you list an item with the Trading API. - `price` Amount — A complex type that describes the value of a monetary amount as represented by a global currency. - `currency` string — The base currency applied to the value field to establish a monetary amount. The currency is represented as a 3-letter ISO4217 currency code. For example, the code for the Canadian Dollar is CAD. Default: The default currency of the eBay marketplace that hosts the listing. For implementation help, refer to eBay API documentation - `value` string — The monetary amount in the specified currency. - `quantity` integer — This integer value indicates the number of items in the eBay listing for which the offer is being made. The offer being made by the seller is an "all or nothing" offer, meaning the buyer must purchase the indicated quantity of items in order to receive the discount on the transaction. Default: 1 ## Response `200` Success - SendOfferToInterestedBuyersCollectionResponse — The response object returned from a SendOfferToInterestedBuyers request. - `offers` Offer[] — The offers container returns a list of the offers sent to buyers who have shown an interest in listings included in the offer. - `allowCounterOffer` boolean — If set to true, the buyer is allowed to make a counter-offer to the seller's offer. - `buyer` User — This complex type identifies an eBay user. - `maskedUsername` string — The masked user name is a user name that has certain characters hidden for privacy of the user. - `creationDate` string — The date and time when the seller's offer was created. The returned timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2018-08-20T07:09:00.000Z - `initiatedBy` string — The eBay UserName of the user (seller) who initiated the offer. - `lastModifiedDate` string — The date and time when the offer was last modified. The returned timestamp is formatted as an ISO 8601 string. - `message` string — A seller-defined message related to the offer being made. This message is sent to the list of "interested" buyers along with the offer message from eBay. - `offerDuration` TimeDuration — A complex type that specifies a period of time using a specified time-measurement unit. - `unit` string — A time-measurement unit that specifies a singular period of time. A span of time is defined when you apply the value specified in the value field to the value specified for unit. Time-measurement units can be YEAR, MONTH, DAY, and so on. See TimeDurationUnitEnum for a complete list of possible time-measurement units. For implementation help, refer to eBay API documentation - `value` integer — An integer that represents an amount of time, as measured by the time-measurement unit specified in the unit field. - `offerId` string — A unique eBay-assigned identifier for the offer. - `offerStatus` string — The current state, or status, of an offer. Status states include PENDING, COUNTERED, ACCEPTED, and DECLINED. For implementation help, refer to eBay API documentation - `offerType` string — The type of offer being made. For implementation help, refer to eBay API documentation - `offeredItems` OfferedItem[] — The list of items associated with the offer. Currently, the offer list is restricted to a single offer. - `discountPercentage` string — This value denotes the percentage that the listing in the offer will be discounted from its original listed price. The seller can specify either the exact price of the discounted items with the price field or they can use this field to specify the percentage that the listing will be discounted, but not both. Minimum: 5 Required if you do not specify a price value. - `listingId` string — This value is a unique eBay-assigned ID that identifies the listing to which the offer pertains. A listingId value is generated by eBay when you list an item with the Trading API. - `price` Amount — A complex type that describes the value of a monetary amount as represented by a global currency. - `currency` string — The base currency applied to the value field to establish a monetary amount. The currency is represented as a 3-letter ISO4217 currency code. For example, the code for the Canadian Dollar is CAD. Default: The default currency of the eBay marketplace that hosts the listing. For implementation help, refer to eBay API documentation - `value` string — The monetary amount in the specified currency. - `quantity` integer — This integer value indicates the number of items in the eBay listing for which the offer is being made. The offer being made by the seller is an "all or nothing" offer, meaning the buyer must purchase the indicated quantity of items in order to receive the discount on the transaction. Default: 1 - `revision` string — A unique, eBay-assigned ID for the revision of the offer. ## Other responses - `400` — Bad Request - `409` — Conflict - `500` — Internal Server Error --- [API](https://skmtc.net/ebay/apis/sell-negotiation.md) · [All operations](https://skmtc.net/ebay/apis/sell-negotiation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ebay/sell-negotiation/versions/821df79afc0c/schema)