Actions8
Get Contact Search Status
AI-generatedSummary
Polls the status of an asynchronous DataMerge contact search job by job ID and returns the API's status response, which per the node description includes the record IDs of found contacts.
Inputs
- Job ID (required) — Job ID returned by the Start Contact Search operation. It is inserted into the request URL (GET /v1/contact/search/{jobId}/status). Evaluated per input item, so it can be an expression.
Output shape
One output item per input item, containing the raw JSON response from the DataMerge contact search status endpoint (job status and, per the node description, record IDs).
The response is passed through unmodified, so exact fields depend on the DataMerge API. The operation does not loop or wait, so you must re-run it (e.g. with a Wait/loop) until the job completes. Use the returned record IDs with the Get Contact operation to fetch full contact details. With Continue On Fail enabled, errors are emitted as items with an error message; otherwise the node throws.
Examples
Example 1: Check whether a contact search started earlier has finished.
Job ID set to the expression {{ $json.job_id }} from the Start Contact Search node's output.
Example 2: Poll a job in a loop until it's done, then fetch contacts.
Wait node, then Get Contact Search Status with the job ID, then an IF node on the status; when complete, pass record IDs to Get Contact.