Upcall confirmations

You can confirm an advertisement upcall by performing a POST against the upcall confirmations controller resource.

Confirming advertisement upcalls is currently restricted to clients authenticating with client credentials. These clients should use a token that has the confirm_upcall scope. Read more about this in the Obtaining an Access Token for a client section of the authentication chapter.


Work in Progress


field type constraints default Req W U
callerPhoneNumber string yes no no
calleePhoneNumber string yes no no
startTime ISO 8601 timestamp yes no no
endTime ISO 8601 timestamp yes no no


The phone number of the caller.


The phone number which has been called.


Time when the call started.


Time when the call ended.


POST /v1/advertisements/{itemId}/upcall-confirmations

Confirm an advertisement upcall.


Confirming an upcall for an advertisement with id 1 :

Request :

POST /v1/advertisements/m1/upcall-confirmations HTTP/1.1
Host: api.marktplaats.nl
Content-Type: application/json

    "callerPhoneNumber": "0615420879",
    "calleePhoneNumber": "0113293823",
    "startTime": "2014-12-02T09:34:21+00:00",
    "endTime": "2014-12-02T09:34:23+00:00"

Response :

HTTP/1.1 201 Created


http error code description
404 advertisement-not-found The advertisement with the provided itemId does not exist.
500 internal-server-error Oops! Sorry, something went wrong on our side.
403 unauthorized The action you are trying to perform is not allowed.