---
title: "Get a Live Data search"
method: GET
path: "/v3/live-data/searches/{id}"
tags: ["Live Data"]
---

# Get a Live Data search

`GET /v3/live-data/searches/{id}`

<Warning>
  **Coming soon.** This endpoint will be available by early July 2026.
</Warning>

<small>_Requires the `contacts:read` scope (or a broader one that includes it)._</small>

Returns a single Live Data search by id, including its status, progress, and the filters it was run with.

## Path parameters

- `id` integer, required

## Response `200`

Search found

- object — Summary of a Live Data search.
  - `id` integer, required — Search id
  - `status` 'inProgress' | 'finished' | 'noMoreContacts' | 'manuallyPaused' | 'pausedDueToInsufficientCredits', 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.
  - `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, nullable — Sequence the found contacts are added to, when configured
  - `sequenceName` string, nullable — Name of the target sequence, when configured
  - `lists` object[] — Prospect lists the found contacts are added to
    - `id` integer, required
    - `name` string, required
  - `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" }`).
    - `accountListIds` object[] — Saved account-list ids the search is scoped to
      - `value` integer, required — The literal integer id to match
      - `type` 'include' | 'exclude' — Whether matching values are included in or excluded from the autopilot search.
    - `industries` object[] — Industry filters
      - `value` string, required — The literal value to match (non-empty)
      - `type` 'include' | 'exclude' — Whether matching values are included in or excluded from the autopilot search.
    - `companyLocations` object[] — Company location filters
      - `value` string, required — The literal value to match (non-empty)
      - `type` 'include' | 'exclude' — Whether matching values are included in or excluded from the autopilot search.
    - `companySizes` string[] — Company size bands to include
    - `headcountGrowth` object, nullable — Min/max range applied to the company's total headcount growth (percent). Either bound may be omitted. When both are provided, `min` must be less than or equal to `max`.
      - `min` integer, nullable — Lower bound (inclusive), percent
      - `max` integer, nullable — Upper bound (inclusive), percent
    - `departmentHeadcountGrowth` object, nullable — Min/max range applied to a specific department's headcount growth (percent). Either bound may be omitted. When both are provided, `min` must be less than or equal to `max`.
      - `min` integer, nullable — Lower bound (inclusive), percent
      - `max` integer, nullable — Upper bound (inclusive), percent
      - `department` string, required — Department name the growth range applies to (non-empty)
    - `minRevenue` 'zeroMillion' | 'halfMillion' | 'oneMillion' | 'twoAndHalfMillion' | 'fiveMillion' | 'tenMillion' | 'twentyMillion' | 'fiftyMillion' | 'oneHundredMillion' | 'fiveHundredMillion' | 'oneThousandMillion' | 'overOneThousandMillion', nullable — Annual revenue tier used when filtering companies for autopilot search.
    - `maxRevenue` 'zeroMillion' | 'halfMillion' | 'oneMillion' | 'twoAndHalfMillion' | 'fiveMillion' | 'tenMillion' | 'twentyMillion' | 'fiftyMillion' | 'oneHundredMillion' | 'fiveHundredMillion' | 'oneThousandMillion' | 'overOneThousandMillion', nullable — Annual revenue tier used when filtering companies for autopilot search.
    - `accountKeywords` object — Boolean keyword filter applied to account or contact searches. In responses this field is always present and non-null even when no keywords are configured (`{ "values": [], "type": "or" }`).
      - `values` object[] — Keyword values combined according to `type`
        - `value` string, required — The literal value to match (non-empty)
        - `type` 'include' | 'exclude' — Whether matching values are included in or excluded from the autopilot search.
      - `type` 'or' | 'and' — Boolean combinator applied across keyword filter values.
    - `isHiringOnLinkedIn` boolean — When `true`, restrict to companies currently hiring on LinkedIn. `false` (the default) applies no filter — it is treated the same as omitting the field.
    - `contactLocations` object[] — Contact location filters
      - `value` string, required — The literal value to match (non-empty)
      - `type` 'include' | 'exclude' — Whether matching values are included in or excluded from the autopilot search.
    - `jobTitles` object[] — Contact job-title filters
      - `value` string, required — The literal value to match (non-empty)
      - `type` 'include' | 'exclude' — Whether matching values are included in or excluded from the autopilot search.
    - `departments` object[] — Contact department filters
      - `value` string, required — The literal value to match (non-empty)
      - `type` 'include' | 'exclude' — Whether matching values are included in or excluded from the autopilot search.
    - `seniorities` string[] — Seniority slugs to include
    - `contactKeywords` object — Boolean keyword filter applied to account or contact searches. In responses this field is always present and non-null even when no keywords are configured (`{ "values": [], "type": "or" }`).
      - `values` object[] — Keyword values combined according to `type`
        - `value` string, required — The literal value to match (non-empty)
        - `type` 'include' | 'exclude' — Whether matching values are included in or excluded from the autopilot search.
      - `type` 'or' | 'and' — Boolean combinator applied across keyword filter values.

## Other responses

- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `404` — Search not found

---

[API](https://skmtc.net/reply/apis/reply-api.md) · [All operations](https://skmtc.net/reply/apis/reply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reply/reply-api/revisions/1c3d32eaf95e/schema)