List your conversations

​

Returns your order and offer conversations, most recent message first. Each order has a conversation with the other party and, for each of you, a conversation with CardNexus support; each offer has one conversation between buyer and seller.

Only conversations with at least one message are returned. Listing conversations does not mark anything as read.

Filter with type, orderNumber or offerId, and unread. Follow pagination.nextCursor until it is null. A conversation that receives a new message moves to the top of the list, so a walk can see it twice or miss it; start again from the first page to catch up. A page can hold fewer conversations than limit while nextCursor is still set.

Requires the messaging:read scope.

Query Parameters

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

    Conversations per page. Default 30, maximum 30.

  • type
    Type: stringenum

    order returns only order conversations; offer returns only offer conversations. Omit to return both.

    values
    • order

      A conversation about an order.

    • offer

      A conversation about an offer.

  • orderNumber
    Type: string
    min length:  
    1

    Return only the conversations of this order: the one with the other party and your support conversation.

  • offerId
    Type: string
    min length:  
    1

    Return only the conversation of this offer.

  • unread
    Type: boolean

    true returns only conversations with messages you have not read. Covers your 100 most recently active unread conversations.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/threads
curl 'https://public-api.cardnexus.com/v1/threads?limit=30&type=order' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "id": "b3JkZXI6T1ItQVNOQkMtMTptYWlu",
      "context": {
        "type": "order",
        "orderNumber": "OR-ASNBC-1",
        "scope": "main",
        "yourRole": "seller"
      },
      "participants": [
        {
          "username": "alphabay_cards",
          "role": "buyer"
        }
      ],
      "unreadCount": 2,
      "lastMessageAt": "2026-06-14T10:00:00.000Z",
      "canSend": true
    },
    {
      "id": "b2ZmZXI6NjY1ZjNhMmIxYzhkNGU5ZjdhNmI1YzU5",
      "context": {
        "type": "offer",
        "offerId": "665f3a2b1c8d4e9f7a6b5c59",
        "yourRole": "seller"
      },
      "participants": [
        {
          "username": "north_arena_tcg",
          "role": "buyer"
        }
      ],
      "unreadCount": 0,
      "lastMessageAt": "2026-06-13T17:42:10.000Z",
      "canSend": true
    }
  ],
  "pagination": {
    "nextCursor": "eyJvZmZzZXQiOjMwfQ"
  }
}

Conversations returned.

Previous
Messaging
Next
Get a conversation