Get candidate
One candidate record with contact fields, location, skills and work history.
GET https://cotlet.dev/api/v1/jobdiva/candidates/{candidate_id}
read
Returns the name, contact fields, location, skills and work history shown on the record. Notes are not included; list_candidate_notes reads them. A record you cannot open in JobDiva answers APP_PERMISSION_DENIED.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id integer required | integer | Candidate ID from search_candidates or find_candidate. |
Request
curl https://cotlet.dev/api/v1/jobdiva/candidates/1 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("jobdiva", "get_candidate", {"candidate_id":1})const result = await cotlet.call('jobdiva', 'get_candidate', {"candidate_id":1});cotlet call jobdiva get_candidate --data '{"candidate_id":1}'Example response
{
"candidate_id": 5821904,
"name": "Priya Raman",
"email": "priya.raman@example.com",
"phone": "+1 312 555 0147",
"location": "Chicago, IL",
"skills": [
"SQL",
"dbt",
"Looker"
],
"experience": [
{
"title": "Data Analyst",
"company": "Brightpath Retail",
"from": "2020-03",
"to": null
}
]
}