Bids

Collection of embedded bid representations.

Relations

name	availability	embedded	cardinality
mp:bid	always	yes	0..N

Reference

GET /v1/advertisements/{itemId}/bids

Returns all bids placed on the advertisement ordered by a bid amount.

Examples

Getting all bids for an advertisement :

Request :

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

Response :

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

{
  "_links": {
    "self": { "href": "/v1/advertisements/m1/bids" },
    "curies": [
      {
        "name": "mp",
        "href": "https://api.marktplaats.nl/docs/v1/{rel}.html",
        "templated": true
      }
    ]
  },
 "_embedded": {
   "mp:bid": [
     {
       "_links": {
         "self": { "href": "/v1/advertisements/m1/bids/105" }
       },
       "id": 105,
       "amount": 1200,
       "bidder": {
          "id": 340009,
          "nickName": "John Smith"
       }
     },
     {
       "_links": {
         "self": { "href": "/v1/advertisements/m1/bids/101" }
       },
       "id": 101,
       "amount": 1000,
       "bidder": {
          "id": 100987,
          "nickName": "John Smith"
       }
     }
   ]
 }
}