GoHighLevel Conversations API

Search Conversation

GET/conversations/search

GET /conversations/search Returns a list of all conversations matching the search criteria along with the sort and filter options selected It takes 21 query parameters, requires the conversations.readonly scope and authenticates with a sub-account (location) token.

Request and authentication

Method: GET
Full URL: https://services.leadconnectorhq.com/conversations/search
Scopes: conversations.readonly
Token type: Sub-account (location) token
Accepted auth: OAuth Access Token, Private Integration Token
API version header: Version: 2021-07-28
Schema verified: 22 June 2026

Query parameters

Appended to the URL as a query string.

Name	Type	Description
`locationId`required	`string`	Example: `ABCHkzuJQ8ZMd4Te84GK`
`contactId`	`string`	Example: `9VEmS0si86GW6gXWU89b`
`assignedTo`	`string`	Example: `ABCHkzuJQ8ZMd4Te84GK,fGiae4CHkzoskh8thsik`
`followers`	`string`	Example: `ABCHkzuJQ8ZMd4Te84GK,fGiae4CHkzoskh8thsik`
`mentions`	`string`	Example: `ABCHkzuJQ8ZMd4Te84GK,fGiae4CHkzoskh8thsik`
`query`	`string`	Example: `Search string`
`sort`	`string`	One of: `asc`, `desc` Example: `asc`
`startAfterDate`	`any`	Example: `1600854`
`id`	`string`	Example: `ABCHkzuJQ8ZMd4Te84GK`
`limit`	`number`	Example: `20`
`lastMessageType`	`string`	One of: `TYPE_CALL`, `TYPE_SMS`, `TYPE_RCS`, `TYPE_EMAIL`, `TYPE_SMS_REVIEW_REQUEST`, `TYPE_WEBCHAT`, `TYPE_SMS_NO_SHOW_REQUEST`, `TYPE_CAMPAIGN_SMS`, `TYPE_CAMPAIGN_CALL`, `TYPE_CAMPAIGN_EMAIL`, `TYPE_CAMPAIGN_VOICEMAIL`, `TYPE_FACEBOOK`, `TYPE_CAMPAIGN_FACEBOOK`, `TYPE_CAMPAIGN_MANUAL_CALL`, `TYPE_CAMPAIGN_MANUAL_SMS`, `TYPE_GMB`, `TYPE_CAMPAIGN_GMB`, `TYPE_REVIEW`, `TYPE_INSTAGRAM`, `TYPE_WHATSAPP` Example: `TYPE_SMS`
`lastMessageAction`	`string`	One of: `automated`, `manual` Example: `manual`
`lastMessageDirection`	`string`	One of: `inbound`, `outbound` Example: `inbound`
`status`	`string`	One of: `all`, `read`, `unread`, `starred`, `recents` Example: `all`
`sortBy`	`string`	One of: `last_manual_message_date`, `last_message_date`, `score_profile`, `overdue_at`, `due_at` Example: `last_message_date`
`sortScoreProfile`	`string`	Example: `ABCHkzuJQ8ZMd4Te84GK`
`scoreProfile`	`string`	Example: `ABCHkzuJQ8ZMd4Te84GK`
`scoreProfileMin`	`number`	Example: `ABCHkzuJQ8ZMd4Te84GK`
`scoreProfileMax`	`number`	Example: `ABCHkzuJQ8ZMd4Te84GK`
`startDate`	`number`	Example: `1640995200000`
`endDate`	`number`	Example: `1672531199000`

Response fields

Top-level fields returned on a successful call.

Name Type Description

conversationsrequired

array

The list of all conversations found for the given query

totalrequired

number

Total Number of results found for the given query

Example: 100

Example request

Copy-paste ready. Swap YOUR_TOKEN for your access token or Private Integration Token.

curl -X GET 'https://services.leadconnectorhq.com/conversations/search' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28'

Skip the schema lookup

Hylo gives your AI agent this schema — and the other 52 documented here — without you looking anything up. Ask in plain English; it picks the endpoint, fills the body, and can run the call against your own sub-account.

View pricing Read the setup guide

More conversations endpoints