Bid

Bid is an (price) offer for an advertisement. Seller can enable or disable bids on their ads. Bids can have minimal bid and asking price. See bidding for the more detail.

Fields

field	type	constraints	default	Req	W	U
bidId	int	–		yes	no	no
amount	int	non negative		yes	yes	no
placeDate	ISO 8601 timestamp	–		no	no	no
bidder.id	int	–		yes	no	no
bidder.nickName	string	–		yes	yes	no

bidId

The bid id.

amount

The bid amount.

placeDate

The date the bid has been placed.

bidder.id

The bidder’s user id.

bidder.nickName

The nick name of the bidder.

Relations

name	availability	embedded	cardinality
mp:bidder	always	no	1

Reference

GET /v1/advertisements/{itemId}/bids/{bidId}

Returns specific bid on the advertisement.

DELETE /v1/advertisements/{itemId}/bids/{bidId}

Deletes the specific bid on the advertisement. The bid can be deleted either by the owner of the bid or the owner of the advertisement.

Errors

http	error code	description
404	bid-not-found	The bid doesn’t exist
403	unauthorized	The user is not authorized to delete the bid

Examples

Getting specific bid for an advertisement :

Request :

GET /v1/advertisements/m1/bids/2 HTTP/1.1
Host: api.marktplaats.nl

Response :

HTTP/1.1 200 OK
Content-Type: application/json

{
  "_links": {
    "self": {
      "href": "/v1/advertisements/m1/bids/2"
    },
    "mp:bidder": {
      "href": "/v1/users/7713"
    }
  },
  "id": 2,
  "amount": 1100,
  "bidder": {
    "id": 7713,
    "nickName": "Joe"
  }
}

Deleting a specific bid for an advertisement :

Request :

DELETE /v1/advertisements/m1/bids/4 HTTP/1.1
Host: api.marktplaats.nl

Response :

HTTP/1.1 200 OK