BidCancelledv0.0.1
Holds information about bids cancelled by a client in an online auction.
When firing this event make sure you set the `correlationId` in the headers. Our schemas have standard metadata make sure you read and follow it.
Details
This event can be triggered multiple times per client, for a particular auction and lot. When a client cancels a bid in an online auction, it will trigger this event.
Consumer / Producer Diagram
BidCancelled Schema (json)
{
"$id": "https://example.com/BidCancelled.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "BidCancelled",
"description": "An event raised when a bid is cancelled in an online auction",
"type": "object",
"properties": {
"metadata": {
"type": "object",
"properties": {
"occurredAtUtc": {
"type": "string",
"description": "The date and time when event occurred in UTC. Date should be represented in ISO 8601 format e.g 2023-09-08T12:00:00Z"
},
"typeName": {
"type": "string",
"description": "The name of the event. E.g BidCancelled"
},
"source": {
"type": "string",
"description": "The source channel of the original bid. Valid values - Web > Online, Admin > Online, WeChat > Online, iOS > Online, Web > Live, Admin > Live, WeChat > Live, iOS > Live"
},
"sourceTimeZone": {
"type": "string",
"description": "Timezone of the client source when bid was cancelled"
},
"version": {
"type": "string",
"description": "Version number in format of V{n} for e.g V1, V2"
},
"sentAtUtc": {
"type": "string",
"description": "When was the event sent by the publishers. In ISO 8601"
}
},
"required": [ "occurredAtUtc", "typeName", "sentAtUtc", "version"]
}
},
"data": {
"type": "object",
"properties": {
"lotId": {
"type": "string",
"description": "Unique id of the lot the bid is being cancelled for. This is the sale number and lot number and lot suffix e.g. 21231.5a"
},
"cancelledBidId": {
"type": "string",
"description": "The ID of the originally placed bid that has now been cancelled."
},
"winningBidId": {
"type": "string",
"description": "The bid id of the current winning bid. This is only optional because it is possible it is the first bid being cancelled."
},
"winningClientNumber": {
"type": "string",
"description": "COS number of the client that currently has the winning bid."
},
"winningAccountNumber": {
"type": "string",
"description": "The account number of the originally placed bid that is now the winningAccountNumber."
},
"bidCount": {
"type": "number",
"description": "Current number of bids for the lot."
},
"startingBid": {
"type": "number",
"description": "The starting bid value of the lot if there is no current winning bid and all bids have been cancelled on the lot. e.g. 15000.00"
},
"winningBid": {
"type": "number",
"description": "The current winning bid value. e.g. 15000.00"
},
"winningBidCurrency": {
"type": "string",
"description": "The 3 character currency code of the original bid which is now the current winning bid. e.g. GBP"
},
"winningBidType": {
"type": "string",
"description": "The bid type of original bid which is now the current winningBid. e.g. Automatic"
},
"biddingExtended": {
"type": "boolean",
"description": "If the time to bid has been extended or not. e.g. True or False"
},
"biddingEndTimeUtc": {
"type": "string",
"description": "Date and time bidding ends on the lot e.g. 2022-02-10T14:30:00Z. (ISO8601 format in Zulu/UTC time)"
},
"lotTitle": {
"type": "string",
"description": "The english title of the lot the bid was originally placed for."
}
}
}
}Edit this pageLast updated on 2026/1/30