Skip to main content
GET
/
api
/
replies
Check replies for a lead (or campaign)
curl --request GET \
  --url https://app.tuco.ai/api/replies \
  --header 'Authorization: Bearer <token>'
{
  "replies": [
    {
      "leadId": "69b2c41d352a78479d2c623b",
      "messageId": "69b340dd6dae1d942ece4d09",
      "respondedAtUtc": "2026-03-12T22:40:29.174Z",
      "recipientPhone": "+919042956129",
      "recipientEmail": "goforbg@icloud.com",
      "name": "BG Real",
      "parentMessages": [
        {
          "messageId": "69b344bc6dae1d942ece4d0e",
          "message": "Here's your document.",
          "sentAtUtc": "2026-03-12T22:57:02.892Z",
          "batchId": null,
          "stepIndex": null
        }
      ]
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50,
  "totalPages": 1
}

Authorizations

​
Authorization
string
header
required

Workspace API key: Authorization: Bearer tuco_sk_xxxxxxxxxxxxx

Query Parameters

​
leadId
string

Replies from this lead only

​
campaignId
string

Replies from leads in this campaign

​
recipientEmail
string
​
recipientPhone
string
​
page
integer
default:1
​
limit
integer
default:50

Response

Replies list

​
replies
object[]
​
total
integer
​
page
integer
​
limit
integer
​
totalPages
integer