Get a Live Data search
Returns a single Live Data search by id, including its status, progress, and the filters it was run with.
Authorizations
Authenticate every request with a Bearer token. Pass your Reply API key in the
Authorization header:
Authorization: Bearer <your-api-key>
Get your API key from the Reply dashboard: Settings → API Key.
Path Parameters
Search id
x >= 1Response
Search found
A single Live Data search, including the filters it was run with.
Search id
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.
inProgress, finished, noMoreContacts, manuallyPaused, pausedDueToInsufficientCredits When the search started (UTC)
Number of contacts found and added so far
Total credits spent by the search (contacts + emails + phones)
Id of the user who started the search
Sequence the found contacts are added to, when configured
Name of the target sequence, when configured
Prospect lists the found contacts are added to
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" }).