Get candidate

One candidate profile with contact details, education and work history.

GET https://cotlet.dev/api/v1/manatal/candidates/{candidate_id}

read

Returns the profile as the candidate overview shows it: contact details, current position, education, work experience, tags and the owner. Resume files are not returned. A candidate you cannot open with your role fails with APP_PERMISSION_DENIED.

Parameters

Parameters: get_candidate
NameTypeDescription
candidate_id integer required integer Candidate ID from search_candidates.

Request

cURL
curl https://cotlet.dev/api/v1/manatal/candidates/1 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("manatal", "get_candidate", {"candidate_id":1})
Node.js
const result = await cotlet.call('manatal', 'get_candidate', {"candidate_id":1});
CLI
cotlet call manatal get_candidate --data '{"candidate_id":1}'

Example response

JSON

{
  "candidate_id": 48213,
  "name": "Daniel Reyes",
  "email": "daniel.reyes@example.com",
  "phone": "+1 555 0100",
  "current_position": "Senior Product Designer",
  "current_company": "Brightwell",
  "education": [
    {
      "school": "Riverside University",
      "degree": "BA Design"
    }
  ],
  "experience": [
    {
      "position": "Product Designer",
      "employer": "Brightwell",
      "from": "2022-03",
      "to": null
    }
  ],
  "tags": [
    "design"
  ],
  "owner": "Lena Fischer"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.