Skip to main content

A single Live Data search, including the filters it was run with.

id
integer
required

Search id

status
enum<string>
required

Lifecycle status of a Live Data search.

  • inProgress — actively searching and adding contacts.
  • finished — completed; the requested number of contacts was added.
  • noMoreContacts — completed; the audience was exhausted before the requested count was reached.
  • manuallyPaused — paused by the user.
  • pausedDueToInsufficientCredits — paused because the team ran out of credits.
Available options:
inProgress,
finished,
noMoreContacts,
manuallyPaused,
pausedDueToInsufficientCredits
startedAt
string<date-time>
required

When the search started (UTC)

contactsFound
integer

Number of contacts found and added so far

usedCredits
integer

Total credits spent by the search (contacts + emails + phones)

userId
integer

Id of the user who started the search

sequenceId
integer | null

Sequence the found contacts are added to, when configured

sequenceName
string | null

Name of the target sequence, when configured

lists
object[]

Prospect lists the found contacts are added to

filters
Live Data filters · object

Account- and contact-level filter configuration for a Live Data search.

Most collections are capped at 25 items. accountKeywords and contactKeywords are always present and non-null in responses even when empty ({ "values": [], "type": "or" }).