INinstantly
AILeadFinderAgent

List AI Lead Finder Agent activities

Changed on

List the activity events of an AI Lead Finder Agent, 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/{id}/activities

Request

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

Path parameters

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

AI Lead Finder Agent ID

Query parameters

limitinteger
Example:10

The number of items to return

starting_afterstring
Example:WyIyMDI2LTA4LTAzVDEwOjAwOjAwLjAwMFoiLCIwMTk4Il0

Opaque pagination cursor - pass the next_starting_after value from the previous response. Do not construct it manually.

Response

The activity events of the agent

next_starting_afterstring

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

Example response

{
  "items": [
    {
      "id": "01a19e6f-7f20-73d7-9ec4-6aaec47512ac",
      "agent_id": "01a19e6f-7f20-73d7-9ec4-6aaec47512ac",
      "organization_id": "01a19e6f-7f20-73d7-9ec4-6aaec47512ac",
      "timestamp_created": "2026-11-02T22:44:29.600Z",
      "event_type": "top_up_completed",
      "payload": {
        "leads_added": 25,
        "campaign_active_leads_after": 75,
        "reason": "Enrichment failed"
      }
    }
  ],
  "next_starting_after": "WyIyMDI2LTA4LTAzVDEwOjAwOjAwLjAwMFoiLCIwMTk4Il0"
}

Changes