/company/{id}/candidates/search

Finds candidates in the company whose email address matches email_address, searching company-wide across all positions rather than within a single job. Matching is exact on the normalized (lowercased, trimmed) email address — not a partial or fuzzy text search.

Returns an array with one lightweight entry per matching candidate. Each entry contains only the candidate's _id, name, and creation_date, plus the position the candidate is associated with. This is a much smaller shape than the standard candidate list object — the other ListCandidate fields (email_address, stage, source, resume, tags, etc.) are not returned by this endpoint.

The email_address query parameter is required; requests without it return 400. This verb is the exact-email lookup - free-text search across the whole company is the POST form of this same path. The one exception is the deprecated filter_text parameter below, which is served by the POST behaviour and returns that envelope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Query Params
string
required
string
deprecated

Deprecated free-text search on this verb, kept working for existing integrations only. When supplied without email_address the request is served by the POST form of this path and returns that paginated envelope instead of the array documented below, and the response carries a Deprecation header. New integrations should call POST on this path.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json