Skip to main content
GET
Check Replies
Use this endpoint to check if a specific lead has replied, or to list all leads who replied (optionally scoped to a campaign). Returns the reply text, up to 10 recent replies from the lead, and up to 10 outbound messages you sent them.

Authentication

Query parameters

leadId
string
Replies from this lead only (valid ObjectId; returns 404 if lead not found).
campaignId
string
Restrict to leads who replied and are in this campaign.
recipientEmail
string
Filter by reply sender email.
recipientPhone
string
Filter by reply sender phone (E.164 or normalized).
lineId
string
Restrict to replies received on this Tuco line (24-char ObjectId hex). Returns 400 if malformed.
dateFrom
string
Inclusive ISO 8601 UTC lower bound on the reply timestamp (e.g. 2026-06-01T00:00:00Z). Returns 400 if unparseable or greater than dateTo.
dateTo
string
Inclusive ISO 8601 UTC upper bound on the reply timestamp.
page
number
default:"1"
Page number.
limit
number
default:"50"
Results per page (max 100).

Examples


Success response (200)

Reply fields

leadId
string
Lead who replied.
messageId
string
ID of the most recent reply message.
message
string
The reply text (e.g. “Stop”, “Interested!”, “Call me tomorrow”).
respondedAtUtc
string
ISO 8601 timestamp of the most recent reply.
recipientPhone
string
Lead’s phone number.
recipientEmail
string
Lead’s email address.
name
string
Lead’s display name.
hasReplied
boolean
true when the lead’s newest inbound is newer than your newest outbound to them (no outbound on record → true). Any follow-up you send after their reply — including AI copilot auto-replies — flips it back to false. With campaignId set, outbounds are scoped to that campaign, so this reads as “replied since the campaign’s last message”.
hasEverReplied
boolean
Always true for a returned row — leads who never replied have no row. Included so this endpoint and the GHL Check for Replies action expose the same field names; branch on it when an auto-responder makes hasReplied flip to false within seconds.

recentReplies (up to 10)

All inbound replies from this lead, newest first. Gives you the full conversation context from their side.
recentReplies
array

parentMessages (up to 10)

Outbound messages you sent to this lead, newest first. Shows what you said before they replied.
parentMessages
array

Error responses