INinstantly
AILeadFinderAgent

List AI Lead Finder Agents

Changed on

List the AI Lead Finder Agents of the workspace, newest first.

Requires one of the following scopes: ai_agents:read, ai_agents:all, all:read, all:all

get/api/v2/ai-agents/lead-finder

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/ai-agents/lead-finder
  • Auth
    HTTP bearer

Query parameters

limitinteger
Example:10

The number of items to return

starting_afterstring uuid
Example:01a19e6f-7f20-73d7-9ec4-6aaec47512ac

The ID of the last item in the previous page - used for pagination. You can use the value of the next_starting_after field from the previous response.

campaign_idstring uuid
Example:01a19e6f-7f20-73d7-9ec4-6aaec47512ac

Only return the agent keeping this campaign stocked (active or paused). A campaign has at most one agent, so the list holds zero or one item and limit / starting_after are ignored; next_starting_after is omitted.

Response

The AI Lead Finder Agents of the workspace

next_starting_afterstring

Pass as starting_after to fetch the next page. Absent on the last page.

Example response

{
  "items": [
    {
      "id": "01a19e6f-5074-7a90-9d10-535a367c0bf1",
      "organization_id": "01a19e6f-5074-7a90-9d10-535b0a6d005c",
      "name": "Test AI Agent",
      "payload": {
        "campaign_id": "01a19e6f-5074-7a90-9d10-5358888d7c91",
        "campaign_name": "Outbound US",
        "min_active_leads": 50,
        "on_exhaustion": "pause",
        "ai_enrichment_workflow": "custom:0198c2a4-3f1e-7000-8000-000000000000"
      },
      "type": 6,
      "timestamp_created": "2026-11-02T22:44:17.652Z",
      "timestamp_updated": "2026-11-02T22:44:17.652Z",
      "status": 1,
      "created_by": "01a19e6f-5074-7a90-9d10-535cef352927",
      "description": "Optional agent description"
    }
  ],
  "next_starting_after": "01a19e6f-7f20-73d7-9ec4-6aaf78520112"
}

Changes