RevKeen Docs
Api reference

List conversation threads

List conversation threads for the authenticated merchant


Related endpoints

  • POST /comms/send — Send a message
  • GET /comms/threads/{threadId}/messages — List messages in a thread

Pagination

Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.

GET
/comms/threads
x-api-key<token>

Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.

In: header

Query Parameters

customerId?string

Filter by customer UUID

Formatuuid
status?string

Filter by thread status

Value in"open" | "closed" | "pending"
channel?string

Filter by channel

invoiceId?string

Filter by related invoice UUID

Formatuuid
limit?number

Maximum number of results (1-100)

Default50
Range1 <= value <= 100
offset?|

Number of results to skip

Default0
Range0 <= value

Response Body

application/json

curl "https://api.revkeen.com/v2/comms/threads" \  -H "x-api-key: $REVKEEN_API_KEY"
{
  "threads": [
    {}
  ],
  "total": 0,
  "limit": 0,
  "offset": 0
}