A complex type that defines an offer that a seller makes to eligible buyers.
Type that uses Offer
SendOfferToInterestedBuyersCollectionResponse
Call that uses Offer
Fields
allowCounterOffer
If set to
true
, the buyer is allowed to make a counter-offer to the seller's offer.creationDate
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:
Example:
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
The eBay UserName of the user (seller) who initiated the offer.
Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to Data Handling Compliance.
Note: Effective September 26, 2025, select developers will no longer receive username data for U.S. users through this field. Instead, an immutable user ID will be returned in its place. For more information, please refer to Data Handling Compliance.
lastModifiedDate
The date and time when the offer was last modified.
The returned timestamp is formatted as an ISO 8601 string.
The returned timestamp is formatted as an ISO 8601 string.
message
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
The length of time that the offer is valid.
The duration of the offer begins at the date and time denoted by creationDate. When the span of time specified by offerDuration passes beyond the creationDate, the offer expires.
The duration of the offer begins at the date and time denoted by creationDate. When the span of time specified by offerDuration passes beyond the creationDate, the offer expires.
offeredItems
array of OfferedItem
The list of items associated with the offer.
Currently, the offer list is restricted to a single offer.
Currently, the offer list is restricted to a single offer.
offerStatus
The current state, or status, of an offer.
Status states include
Status states include
PENDING
, COUNTERED
, ACCEPTED
, and DECLINED
.