Returns the campaign leads of the specified campaign, deactivated ones included, in ascending id order. Use metadata.next_cursor to fetch the next page; it is null on the last page. metadata.total counts every campaign lead matching the filter, not only the current page.
No change history is stored. To keep a copy in sync, poll with updated_at[gte] set to the start time of your previous pull minus 5 minutes and de-duplicate the rows by id: a row is stamped before the write that carries it commits, and the overlap catches it. updated_at moves on every change to a campaign lead, a new dial attempt and a deactivation included. Pull once a minute per active campaign. This method shares the campaign leads limit of 1000 requests a minute per token with lead create and update; a 429 response means retry after a minute.
Deactivated campaign leads stay listed. When the leads of a stopped or completed campaign are cleaned up, nightly after its dispositions report is downloaded, the method returns an empty list with total: 0.