Find candidate
Quick search for a candidate by name, email, phone or address.
GET https://cotlet.dev/api/v1/jobdiva/candidates/find
read
Matches first name, last name, email, alternate email, work, home and cell phone, fax and address. Returns every record that matches, so a common name gives several rows; compare location and title before you use one. Use it to check whether a person already exists before create_candidate.
Parameters
| Name | Type | Description |
|---|---|---|
| value string required | string | Name, email, phone or address to look for. |
| limit integer | integer | Maximum number of records returned. |
Request
curl "https://cotlet.dev/api/v1/jobdiva/candidates/find?value=value" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("jobdiva", "find_candidate", {"value":"value"})const result = await cotlet.call('jobdiva', 'find_candidate', {"value":"value"});cotlet call jobdiva find_candidate --data '{"value":"value"}'Example response
{
"candidates": [
{
"candidate_id": 5821904,
"name": "Priya Raman",
"title": "Data Analyst",
"location": "Chicago, IL",
"email": "priya.raman@example.com"
}
]
}