Skip to main content
GET
List AI Sales Agent lead activity

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

AI Sales Agent ID

Example:

"01a0206f-e414-76cf-8ce7-a2439b5bad4c"

Query Parameters

start_date
string<date-time>

Start date filter (ISO 8601). When omitted, results are not bounded by a start date (all-time data up to end_date).

Example:

"2026-08-20T18:29:58.932Z"

end_date
string<date-time>

End date filter (ISO 8601). When omitted, results run up to the present.

Example:

"2026-08-20T18:29:58.932Z"

filter
enum<string>

Optional filter for the lead set.

Available options:
replied,
has_opportunity
Example:

"replied"

limit
integer

Number of leads to return (default 100)

Required range: 1 <= x <= 100
Example:

100

starting_after
string

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

Example:

"lead@example.com"

Response

Per-lead activity data with cursor pagination

items
object[]
required

The list of leads with activity

total
integer
required

Total number of distinct leads with activity (after the filter is applied)

Example:

250

next_starting_after
string

The filter for getting the next leads after this one. Omitted when there are no more leads.

Example:

"lead@example.com"