Read a conversation

​

Returns the messages of one of your conversations, newest first. Messages include the automatic order and offer updates shown in the conversation (sender.role: "system").

By default, reading the first page marks the conversation as read, the same as opening it on CardNexus: its messages stop counting as unread for you, on the API and in the CardNexus apps. Send markAsRead: false to read without changing it. Pages fetched with a cursor go back in time and do not change what is marked as read.

Follow pagination.nextCursor to fetch older messages until it is null. The default limit is 50 and the maximum is 100. File links in attachments are temporary; fetch the messages again for fresh links.

Requires the messaging:read scope.

Path Parameters

  • threadId
    Type: string
    min length:  
    1
    max length:  
    200
    required

    A stable, opaque conversation ID. Treat it as a token — don't parse it.

Query Parameters

  • cursor
    Type: string
  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Integer numbers.

  • markAsRead
    Type: boolean

    true (the default) marks the conversation as read when you fetch its first page. false leaves what is marked as read unchanged. Pages fetched with a cursor never change it.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/threads/{threadId}/messages
curl 'https://public-api.cardnexus.com/v1/threads/b3JkZXI6T1ItQVNOQkMtMTptYWlu/messages?limit=50&markAsRead=true' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "id": "e5f0a1b2c3d4e5f6a7b8c9d1",
      "threadId": "b3JkZXI6T1ItQVNOQkMtMTptYWlu",
      "sender": {
        "username": "north_arena_tcg",
        "role": "seller"
      },
      "text": "Sure — it goes out tomorrow in a top loader.",
      "attachments": [],
      "sentAt": "2026-06-14T10:12:40.000Z"
    },
    {
      "id": "e5f0a1b2c3d4e5f6a7b8c9d0",
      "threadId": "b3JkZXI6T1ItQVNOQkMtMTptYWlu",
      "sender": {
        "username": "alphabay_cards",
        "role": "buyer"
      },
      "text": "Could you ship the Charizard ex in a top loader?",
      "attachments": [],
      "sentAt": "2026-06-14T10:00:00.000Z"
    }
  ],
  "pagination": {
    "nextCursor": "eyJiZWZvcmUiOiJlNWYwYTFiMmMzZDRlNWY2YTdiOGM5Y2YifQ"
  }
}

Messages returned; the conversation is marked as read unless markAsRead is false.

Previous
Get a conversation
Next
Send a message