Search Candidate by Email

GET

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

Last modified:2026-07-28 11:05:53

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:

{
    "success": "OK",
    "content": [
        {"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

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🟠403

🟠423

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

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

Modified at 2026-07-28 11:05:53

Add Candidate to Job Post or Talent Pool

List Company Offices