Skip to main content
GET
Get a contact search

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Path Parameters

searchID
string
required

Contact search UUID, as returned by Start a contact search. Not the contacts list's id — see contacts_list_id.

Response

OK

company_linkedin_ids
string[] | null
required
contacts_list_id
string
required

The contacts list this search delivers into. This is the id to read results with — List the contacts in a contacts list — and several searches may share one.

created_at
string<date-time>
required
created_by_user_email
string
required

Whatever user_email the submission carried; empty when it carried none.

id
string
required

The SEARCH's id. Pass it to the status and stop operations.

name
string
required

Derived at submit time from the queries and companies, e.g. 'Revenue leadership @ Acme, Globex and 3 others'.

queries
object[] | null
required

The queries as submitted, frozen. A persona edited since does not change them.

status
object
required
already_existed
boolean

Only on a create: true when your idempotency_key matched a submission already in flight, so this is that search rather than a new one.