A Marktplaats user. Email, phoneNumber and postcode are only returned when the user resource you are retrieving represents the logged in user.


field type constraints default Req W U
userId int no no no
locale string for Marktplaats only nl-NL allowed, for 2dehands: nl-BE and fr-BE allowed no yes yes
status string one of unconfirmed, confirmed no yes no
email string valid email address unique within Marktplaats yes yes yes
name string max. 30 chars no yes yes
phoneNumber string no yes yes
postcode string max. 6 chars no yes yes
confirmDate ISO 8601 string no no no
trackingProgram string no no no
dealerPackage string should be NONE, BASIC, PLUS or PREMIUM. no no no
billing Billing yes no no


Uniquely identifies a user


The locale used for the user. This is only relevant for users on the 2dehands platform.


Status of this user. This field may be used to create a user account without the email confirmation.


The email address for this account


The name of the user


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 of the location where the user lives


When the account was confirmed


The name of user’s tracking program, e.g. cps


The name of user’s dealer package or NONE if not present. Possible values for this field are NONE, BASIC, PLUS or PREMIUM


The user’s billing status.


name availability embedded cardinality
mp:user-features always no 1
mp:user-profile always no 1
mp:change-email When you are the logged in user no 1
mp:user-advertisements always no 1
mp:user-reviews always no 1
mp:user-statistics always no 1


GET /v1/users/{userId}

Get a user.


http error code description
400 validation-failure
Validation of the user failed.
There should be more information in the field errors.

Field errors

field error code error value description
email email-in-use The specified email is already in use
phoneNumber input-invalid The phonenumber is in an invalid format
postcode input-invalid The postcode is unknown or in an invalid format


Retrieving a user :

Request :

GET /v1/users/1 HTTP/1.1

Response :

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

  "_links": {
    "self": {
      "href": "/v1/users/1"
    "curies": [
        "href": "{rel}.html",
        "templated": true,
        "name": "mp"
    "mp:change-email": {
      "href": "/v1/users/1/change-email"
  "userId": 1,
  "email": "",
  "name": "Robin",
  "postcode": "8302JM",
  "phoneNumber": "0651649077",
  "status": "confirmed",
  "billing": {
      "profile": "Complete"

Updating a User

Using PUT or PATCH a user’s info can be updated. See Fields for a complete overview of what user info can be updated.

N.B. When updating a user’s info we DO NOT overwrite existing user info in the advertisements of the user.

Field errors

field error code error value description
name input-invalid The supplied name is empty or invalid
phoneNumber input-invalid The phonenumber has an invalid format
postcode input-invalid The postcode is unknown or has an invalid format
name input-too-long The supplied name is too long

Updating the name, phoneNumber and postcode of a user with id 123 using PUT:

Request :

PUT /v1/users/123 HTTP/1.1
Content-Type: application/json

  "name": "new seller name",
  "phoneNumber": "06-00000000",
  "postcode": 1097DN

Updating only the name of a user with id 678 using PATCH:

Request :

PATCH /v1/users/678 HTTP/1.1
Content-Type: application/json-patch+json

  { "op": "replace", "path": "/name", "value": "new seller name" }