List replies and bounces
List sent outreach emails that got a reply or bounced, newest first, with who marked each one.
https://api.rankparse.com/v1/outreach/repliesFreeAPI keyReturns the sent emails of your campaigns that are marked as replied to or bounced, newest mark first. Use it to answer "who replied?", to see how a campaign is doing, or to find the addresses that bounced.
A mark is set in one of two ways: a person marks the email in the dashboard (manual), or RankParse finds the reply or bounce in the connected Gmail mailbox (auto). RankParse reads message headers only, so a reply's text is never part of this response. To answer a reply, open it in Gmail.
Query parameters
typestringdefault allall, reply or bounce. Anything else returns 400 invalid_reply_type.
campaign_idstringOnly this campaign. A campaign that is unknown, archived or outside your workspace returns an empty list, not an error.
site_idstringOnly the campaigns of this website. An unknown website returns an empty list.
limitintegerdefault 50Rows per page, 1 to 200. A larger value is clamped to 200; an invalid value uses the default.
offsetintegerdefault 0Rows to skip. Use it with has_more to read the next page.
Response
automatic_detectionbooleanWhether RankParse looks for replies and bounces in Gmail for your workspace. When it is false, only marks a person made exist, so an email without a mark may still have a reply.
repliesarrayUp to limit rows, newest mark first.
Show propertiesHide properties
lead_idstringThe email's id.
campaign_idstringThe campaign it belongs to.
campaign_namestringThat campaign's name.
site_idstring | nullThe website the campaign belongs to, or null.
domainstringThe prospect's domain.
contact_emailstring | nullThe address the email was sent to.
contact_namestring | nullThe contact's name, if one was given.
sent_atinteger | nullWhen the email was sent, as Unix time in milliseconds.
replied_atinteger | nullWhen the reply was marked, in milliseconds, or null.
replied_sourcestring | nullauto or manual; null when there is no reply mark.
bounced_atinteger | nullWhen the bounce was marked, in milliseconds, or null.
bounced_sourcestring | nullauto or manual; null when there is no bounce mark.
has_morebooleantrue when another page follows.
Behavior and limits
- Order. Newest mark first, whether it is a reply or a bounce. An email with both marks appears once.
- Marks, not messages. The time is when the mark was set (or when RankParse found the message), not necessarily when the person wrote back.
- Archived campaigns are left out.
- Cost and limits: 0 credits, 60 requests per minute per key.
Errors
| HTTP | Code | When |
|---|---|---|
| 400 | invalid_reply_type | type is not all, reply or bounce. |
| 403 | capability_missing | Your role cannot view outreach. |
Plus the shared errors.
Related
MCP tool: outreach_list_replies (accepts type, campaign_id, site_id, limit, offset), on the API-key endpoint. The counts per campaign are also on List campaigns and Get a campaign.