API Documentation >> API 2.0 Main >> Account Management >> Messages

Messages

Allowed HTTP Methods

• GET - Returns the message thread overview of the user
• GET (with idOtherUser) - Returns the message thread with a specified other user
• GET (with idOtherUser and idMessage) - Returns a specified message with a specified other user
• POST (with idOtherUser) - Creates a new message sent to a specified other user
• DELETE (with idOtherUser) - Deletes a complete message thread to a specified other user
• DELETE (with idOtherUser and idMessage) - Deletes a specified message to a specified other user

Resource Information

• Authentication - Required
• Request Object - Message
• Response Format - XML or JSON
• Response Object - Message Thread
• API Version - 2.0
• Resource URI - https://api.cardmarket.com/ws/v2.0/account/messages

Parameters

• idOtherUser (part of URI)
  • User ID of your message partner
  • Type: integer
  • Mandatory/Optional depending on HTTP method and purpose
• idMessage (part of URI)
  • Message ID
  • Type: integer
  • Optional

Example Request

1. Get the message thread overview for the authenticated user:

GET https://api.cardmarket.com/ws/v2.0/account/messages

---

2. Get a complete message thread for messages between the authenticated user and another user:

GET https://api.cardmarket.com/ws/v2.0/account/messages/4398399

---

3. Write a message to another user:

POST https://api.cardmarket.com/ws/v2.0/account/messages/4398399

<?xml version="1.0" encoding="UTF-8" ?>
<request>
    <message>Message text goes here</message>
</request>

---

4. Delete a single message between the authenticated and another user:

DELETE https://api.cardmarket.com/ws/v2.0/account/messages/4398399/47114711

---

5. Delete all messages between the authenticated and another user:

DELETE https://api.cardmarket.com/ws/v2.0/account/messages/4398399