Ask Seller Question

You can send an e-mail to the seller of an advertisement by doing a POST against the ask seller question resource. Asking a question to a seller is only possible for an ad.

field type constraints Req W U
message string yes yes no
phoneNumber string max. 12 characters, has to be a valid yes yes no
postcode string valid postcode no yes no
houseNumber string no yes no

message

The actual message which is send to the seller.

phoneNumber

A phone number has to meet the following requirements:

  • Dutch phone numbers (mobile or land lines) have a maximum length of between 10 and 21 digits and should start with a 0.
  • International phone numbers numbers should start with a ‘+’, followed by a countrynumber and should be between 8 and 19 digits.
  • Phone numbers starting with 0909, 0906, 080x or 090x are not allowed.

Examples of valid phone number:

  • 0615420879 - Valid Dutch mobile phone number.
  • 0308767261 - Valid Dutch land line.
  • 0971492918 - Valid Dutch mobile phone number for tablets and similar devices.
  • +31615587981 - Valid Dutch phone number, with Dutch country code.
  • +49699511440 - Valid German phone number, with country code.

Examples of invalid phone numbers:

  • 0900998877 - Dutch information number.
  • 0906292818 - Dutch chat number.
  • 08001777 - Dutch information number.
  • 061122 - Too short for being a valid number.
  • 003233883399 - Invalid international number, it should start with + instead of 00.

postcode

The postcode of the buyer

houseNumber

The housenumber of the buyer

Reference

POST /v1/advertisements/{itemId}/actions/ask-seller-question

Send a message to the seller of an ad

Example

Asking a question to a seller:

Request :

POST /v1/advertisements/m1/actions/ask-seller-question HTTP/1.1
Host: api.marktplaats.nl
Content-Type: application/json

{
    "message": "Hi, is this item still available?",
    "phoneNumber":"0113293823"
}

Response :

HTTP/1.1 200 OK
Location: https://api.marktplaats.nl/v1/
Content-Type: application/json

{
  "_links":{
    "self":{
      "href":"/v1/advertisements/m1"
    },
    "mp:advertisement":{
      "href":"/v1/advertisements/m1"
    }
  },
  "message": "The seller question on advertisement $itemId has been sent"
}

Errors

http error code description
500 asq-not-sent something went wrong on our side.
403 unauthorized The action you are trying to perform is not allowed
400 validation-failure something is invalid in the ask seller question