Lead source agents

Get one source agent

Retrieve a single source agent by id, with its targeting and signals. Needs the campaigns:read scope.

gethttps://app.replysparrow.com/api/v1/agents/{id}

Authorizations

Authorizationstringheaderrequired

Your API key from Settings → API, sent as Bearer <token>.

Path Parameters

idstringrequired

Agent id

Response

application/json

Agent found

idstringrequired

Agent id

namestringrequired

Agent name

signalsobject[]required

Where the agent looks for leads

pausedbooleanrequired

True when the agent is not finding leads

statusenum<string>required

draft, active or paused

Available options: draftactivepaused

min_lead_scorenumberrequired

Minimum lead score (0-100) a lead needs to be kept

created_atstring<date-time>required

Creation time

updated_atstring<date-time>required

Last change

target_job_titlesstring[]

Job titles of the people to find

target_industriesstring[]

Industries of their companies (see List suggested industries)

target_company_sizesstring[]

Company headcount brackets, e.g. 51-200

target_locationsstring[]

Where the people are (see List suggested locations)

target_company_typesstring[]

Company types, e.g. Private Company, Startup

ignored_companiesstring[]

Companies (and title words) never to source from

mandatory_keywordsstring[]

A lead must mention one of these in headline, title, About or company

exclude_service_providersboolean

Drop agencies, consultancies, freelancers and other B2B service companies

skip_icp_filterboolean

Keep every lead the signals find, without scoring it against the ICP

list_idstring

List the agent imports its leads into

last_runstring<date-time>

When the agent last looked for leads

last_errorstring

The last error the agent hit, if any

Ctrl+I

Get one source agent

curl --request GET \  --url https://app.replysparrow.com/api/v1/agents/string \  --header 'Authorization: Bearer <token>'

{  "id": "5b0f3c2e-8a8e-4bd1-9a51-6f1f3c0f2a10",  "name": "VP Sales in US SaaS",  "target_job_titles": [    "VP Sales",    "Head of Sales"  ],  "target_industries": [    "Software Development"  ],  "target_company_sizes": [    "51-200",    "201-500"  ],  "target_locations": [    "United States"  ],  "target_company_types": [],  "ignored_companies": [    "Globex"  ],  "mandatory_keywords": [],  "exclude_service_providers": true,  "skip_icp_filter": false,  "signals": [    {      "id": "8e2d…",      "type": "competitor_engagement",      "values": [        "https://www.linkedin.com/company/globex/"      ],      "enabled": true    }  ],  "paused": false,  "status": "active",  "min_lead_score": 70,  "list_id": "c1a4…",  "last_run": null,  "last_error": null,  "created_at": "2026-10-24T09:12:44.000Z",  "updated_at": "2026-10-24T09:12:44.000Z"}