RecruitAffiliates.ai

Retrieve a prospect

One prospect with the lists it is on.

Scope: finder:read (or finder:write)

get/v1/finder/prospects/{id}

Request

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

Path parameters

idstring required

Prefixed id (fdi_…)

Example:fdi_7uSyy9FqVLCFWrdPeZaK

Response

The prospect

idstring required

Prefixed id (fdi_…)

object'finder_prospect' required
brand_idstring required

Prefixed id (fbr_…)

channel'website' | 'youtube' | 'podcast' | 'instagram' | 'tiktok' required
sourcestring required
keystring required

The domain, or the YouTube channel id

namestring required
urlstring nullable required
countrystring nullable required
languagestring nullable required
scoreinteger nullable required

0 to 100. Null on YouTube rows until the YouTube score is switched on.

fit'strong' | 'good' | 'possible' | 'weak' | 'null' nullable required
fit_labelstring nullable required
is_newboolean required
savedboolean required
saved_atstring date-time nullable required

ISO-8601, UTC

hiddenboolean required
hidden_atstring date-time nullable required

ISO-8601, UTC

hide_reason'sells_own_product' | 'wrong_audience' | 'too_small' | 'too_big' | 'not_my_topic' | 'other' | 'null' nullable required
stage'saved' | 'contacting' | 'replied' | 'negotiating' | 'onboarding' | 'activated' | 'no_reply' | 'declined' | 'on_hold' | 'null' nullable required
assignee_user_idstring nullable required
list_idsstring[] required
tagsstring[] required
notestring nullable required
emailstring nullable required

Revealed address. Always null on a row marked do not contact.

email_verificationstring nullable required
email_revealed_atstring date-time nullable required

ISO-8601, UTC

follow_up_onstring nullable required

The follow-up date a teammate set, YYYY-MM-DD, or null. The card shows as due from the start of that day (UTC).

last_seen_atstring date-time nullable required

ISO-8601, UTC

created_atstring date-time required

ISO-8601, UTC

updated_atstring date-time required

ISO-8601, UTC

Example response

{
  "id": "fdi_7uSyy9FqVLCFWrdPeZaK",
  "brand_id": "fbr_7uSyy9FqVLCFWrdPeZaK",
  "evidence": [
    {
      "published_at": "2026-08-21T10:15:30.000Z"
    }
  ],
  "saved_at": "2026-08-21T10:15:30.000Z",
  "hidden_at": "2026-08-21T10:15:30.000Z",
  "email_revealed_at": "2026-08-21T10:15:30.000Z",
  "deal": {
    "id": "fdl_7uSyy9FqVLCFWrdPeZaK"
  },
  "last_seen_at": "2026-08-21T10:15:30.000Z",
  "created_at": "2026-08-21T10:15:30.000Z",
  "updated_at": "2026-08-21T10:15:30.000Z",
  "lists": [
    {
      "id": "fls_7uSyy9FqVLCFWrdPeZaK"
    }
  ]
}

Changes

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