Sign in

v1

latestOpenAPI 3.0.0eBay API License Agreement2026-07-1421122.3 KB
offer

This method evaluates a seller's current listings and returns the set of IDs that are eligible for a seller-initiated discount offer to a buyer. A listing ID is returned only when one or more buyers have shown an "interest" in the listing. If any buyers have shown interest in a listing, the seller can initiate a "negotiation" with them by calling sendOfferToInterestedBuyers, which sends all interested buyers a message that offers the listing at a discount. For details about how to create seller offers to buyers, see Sending offers to buyers.

get/find_eligible_items

Query parameters

limitstring

This query parameter specifies the maximum number of items to return from the result set on a page in the paginated response. Minimum: 1    Maximum: 200 Default: 10

offsetstring

This query parameter specifies the number of results to skip in the result set before returning the first result in the paginated response. Combine offset with the limit query parameter to control the items returned in the response. For example, if you supply an offset of 0 and a limit of 10, the first page of the response contains the first 10 results from the complete list of items retrieved by the call. If offset is 10 and limit is 20, the first page of the response contains items 11-30 from the complete result set. Default: 0

Headers

X-EBAY-C-MARKETPLACE-IDstring required

The eBay marketplace on which you want to search for eligible listings. For a complete list of supported marketplaces, see Negotiation API requirements and restrictions.

Response

Success

hrefstring

The URI of the current page of results from the result set.

limitinteger

The number of items returned on a single page from the result set. This value can be set in the request with the limit query parameter.

nextstring

The URI for the following page of results. This value is returned only if there is an additional page of results to display from the result set. Max length: 2048

offsetinteger

The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the offset query parameter. Note: The items in a paginated result set use a zero-based list where the first item in the list has an offset of 0.

prevstring

The URI for the preceding page of results. This value is returned only if there is a previous page of results to display from the result set. Max length: 2048

totalinteger

The total number of items retrieved in the result set. If no items match the search criteria, the server returns the HTTP status code 204 No Content.