Get a conversation
Returns one of your conversations: what it is about, who is in it, how many messages you have not read, and whether you can send messages. It does not return the messages — see GET /v1/threads/{threadId}/messages — and it does not mark anything as read.
The threadId comes from GET /v1/threads or from a message.received webhook. A conversation that is not yours returns NOT_FOUND.
Requires the messaging:read scope.
Path Parameters
- Type: stringthread
Id min length:1max length:200requiredA stable, opaque conversation ID. Treat it as a token — don't parse 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}
curl https://public-api.cardnexus.com/v1/threads/b3JkZXI6T1ItQVNOQkMtMTptYWlu \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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",
"webUrl": "https://cardnexus.com/orders/OR-ASNBC-1?chat=order-OR-ASNBC-1",
"canSend": true
}