Search Candidate by Email

GET

/api/v1/client/candidates/search-by-email/

Last modified:2025-12-30 13:07:46

Searches for candidates by email address within the authenticated company.

Arguments

email (string, as query parameter, required) : The email address to search for. Supports partial matching.

Example: email=john@example.com

Returns

200 OK : An array of matching candidates, each containing the candidate ID and email.

Example Response:

[
  {"id": 123, "email": "john@example.com"},
  {"id": 456, "email": "john.doe@example.com"}
]

400 Bad Request : If the email parameter is not provided.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.recruspace.com/api/v1/client/candidates/search-by-email/?email' \
--header 'Authorization: Bearer <token>'

Response Example

[
    {
        "id": 0,
        "email": "user@example.com"
    }
]

Modified at 2025-12-30 13:07:46