eBay · Schema

BestOffer

This type is used by the bestOfferTerms container, which is used if the seller would like to support the Best Offer feature on their listing.

AuctionsCommerceProductsMarketplaceFortune 500

Properties

Name Type Description
autoAcceptPrice object This is the price at which Best Offers are automatically accepted. If a buyer submits a Best Offer that is equal to or above this value, the offer is automatically accepted on behalf of the seller. Th
autoDeclinePrice object This is the price at which Best Offers are automatically declined. If a buyer submits a Best Offer that is equal to or below this value, the offer is automatically declined on behalf of the seller. Th
bestOfferEnabled boolean This field indicates whether or not the Best Offer feature is enabled for the listing. A seller can enable the Best Offer feature for a listing as long as the category supports the Best Offer feature.
View JSON Schema on GitHub

JSON Schema

ebay-bestoffer-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/BestOffer",
  "title": "BestOffer",
  "type": "object",
  "properties": {
    "autoAcceptPrice": {
      "description": "This is the price at which Best Offers are automatically accepted. If a buyer submits a Best Offer that is equal to or above this value, the offer is automatically accepted on behalf of the seller. This field is only applicable if the <strong>bestOfferEnabled</strong> value is set to <code>true</code>.<br><br>The price set here must be lower than the current 'Buy it Now' price. This field is only returned by <a href=\"/api-docs/sell/inventory/resources/offer/methods/getOffer\">getOffer</a> and <a href=\"/api-docs/sell/inventory/resources/offer/methods/getOffers\">getOffers</a> if set.",
      "$ref": "#/components/schemas/Amount"
    },
    "autoDeclinePrice": {
      "description": "This is the price at which Best Offers are automatically declined. If a buyer submits a Best Offer that is equal to or below this value, the offer is automatically declined on behalf of the seller. This field is only applicable if the <strong>bestOfferEnabled</strong> value is set to <code>true</code>.<br><br>The price set here must be lower than the current 'Buy it Now' price and the price set in the <strong>autoAcceptPrice</strong> field (if used). This field is only returned by <a href=\"/api-docs/sell/inventory/resources/offer/methods/getOffer\">getOffer</a> and <a href=\"/api-docs/sell/inventory/resources/offer/methods/getOffers\">getOffers</a> if set.",
      "$ref": "#/components/schemas/Amount"
    },
    "bestOfferEnabled": {
      "type": "boolean",
      "description": "This field indicates whether or not the Best Offer feature is enabled for the listing. A seller can enable the Best Offer feature for a listing as long as the category supports the Best Offer feature.<br><br>The seller includes this field and sets its value to <code>true</code> to enable Best Offer feature.<br><br><span class=\"tablenote\"><b>Note:</b> Best Offer is not available for multi-variation listings.</span>"
    }
  },
  "description": "This type is used by the <strong>bestOfferTerms</strong> container, which is used if the seller would like to support the Best Offer feature on their listing."
}