Skip to content
Docs

Get Lead Activity

Retrieve the activity timeline and campaign memberships for a lead.

GEThttps://api.foxreach.io/api/v1/leads/{lead_id}/activity

Path Parameters#

lead_idstringpathrequired

The unique identifier of the lead.

Response#

dataobject
Show Activity data
activitiesarray

Chronological list of activities (most recent first, up to 100).

Show Activity object
idstring
Activity identifier.
typestring
email_sent or reply_received.
subjectstring
Email subject line.
bodyPreviewstring
First 200 characters of the body.
statusstring
For email_sent: sent, failed, or bounced.
campaignNamestring
Name of the associated campaign.
sequenceStepinteger
Sequence step number (for email_sent).
emailTypestring
For email_sent: campaign, reply, or warmup.
openedAtstring
ISO 8601 timestamp if email was opened.
clickedAtstring
ISO 8601 timestamp if a link was clicked.
categorystring
AI category (for reply_received).
timestampstring
ISO 8601 timestamp of the activity.
campaignsarray

All campaign memberships for this lead.

Show Campaign membership
campaignIdstring
Campaign ID.
campaignNamestring
Campaign name.
statusstring
pending, sent, paused, or completed.
currentStepinteger
Current sequence step.
totalSentinteger
Emails sent in this campaign.
totalOpenedinteger
Emails opened.
lastSentAtstring
ISO 8601 timestamp of last email sent.
nextSendAtstring
ISO 8601 timestamp of next scheduled email.
repliedAtstring
ISO 8601 timestamp if lead replied.

Errors#

StatusDescription
404Lead not found

Rate Limit#

  • 100 requests per minute, per API key. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 2, 2026