RecruitAffiliates.ai

Retrieve a thread

One thread and its messages, oldest first: who wrote, what kind of reply it was and when. No message bodies: read those in the Mailroom.

Scope: finder:read (or finder:write)

get/v1/finder/threads/{id}

Request

  • Base URL: https://api.affiliaterail.com
  • URL: https://api.affiliaterail.com/v1/finder/threads/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

Prefixed id (fth_…)

Example:fth_7uSyy9FqVLCFWrdPeZaK

Response

The thread

idstring required

Prefixed id (fth_…)

object'finder_thread' required
prospect_idstring nullable required

The matched prospect, or null when the reply matches nobody yet

namestring nullable required
inbox_idstring nullable required
inbox_addressstring required
subjectstring nullable required

Null once the 30-day mail expiry has cleared it

reply_kindstring nullable required

What their latest message was: positive, question, not_now, negative, wrong_person or angry. Null if they haven't written.

last_direction'inbound' | 'outbound' | 'null' nullable required
last_message_atstring date-time nullable required

ISO-8601, UTC

message_countinteger required
needs_replyboolean required
snoozed_untilstring date-time nullable required

ISO-8601, UTC

handled_atstring date-time nullable required

ISO-8601, UTC

stage'saved' | 'contacting' | 'replied' | 'negotiating' | 'onboarding' | 'activated' | 'no_reply' | 'declined' | 'on_hold' | 'null' nullable required
owner_user_idstring nullable required
campaign_idstring nullable required

Example response

{
  "id": "fth_7uSyy9FqVLCFWrdPeZaK",
  "last_message_at": "2026-08-21T10:15:30.000Z",
  "snoozed_until": "2026-08-21T10:15:30.000Z",
  "handled_at": "2026-08-21T10:15:30.000Z",
  "messages": [
    {
      "occurred_at": "2026-08-21T10:15:30.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.