Skip to main content
GET
List conversations

Authorizations

Authorization
string
header
required

Create an API key in GreenTick Developer settings. Send it as Authorization: Bearer gt_live_… (Bearer prefix required).

Query Parameters

phoneNumberRef
string
required

GreenTick phone line ref from GET /phone-numbers (ref field).

limit
integer
default:30
Required range: 1 <= x <= 100
cursor
string

Pagination cursor from a previous response nextCursor field.

Filter by contact name, phone number, or last message preview. Disables cursor pagination.

Response

Conversation list

success
boolean
Example:

true

data
object[]
nextCursor
string | null

Pass as cursor to fetch the next page. Null when there are no more results.