Get candidate

GET

candidates

{candidateId}

Get candidate

curl --request GET \
  --url https://app.kalent.ai/api/v1/candidates/{candidateId} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://app.kalent.ai/api/v1/candidates/{candidateId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.kalent.ai/api/v1/candidates/{candidateId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.kalent.ai/api/v1/candidates/{candidateId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.kalent.ai/api/v1/candidates/{candidateId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

First time? Set up Authentication

Learn how to authenticate your API requests with your API key.

Returns candidate metadata plus a talent payload processed through the same contact-visibility rules as the product UI. Contact objects are not returned directly: visible emails are exposed as talent.emails, and visible sanitized phone numbers are exposed as talent.phones. While enrichment is pending, talent.contactsLoading.email and talent.contactsLoading.phone indicate loading state.

Path parameters

string

required

Candidate id belonging to the API key workspace.

Response

When success is true, data contains:

candidate — id, statusHandle, createdAt, sourcingId, talentId
talent — secured talent fields plus emails, phones, and contactsLoading. Internal LinkedIn/email/WhatsApp interaction flags are not returned.
lastActivityAt, lastActivityDirection, lastActivityChannel, lastActivityContent, replyStatus — latest outreach activity, see below

The response does not expose internal workspaceId or userId fields.

Outreach activity

The same three fields as List candidates, computed with the same rules, so a candidate returns identical values from both endpoints. They aggregate every channel (LinkedIn, email, WhatsApp, SMS) across legacy and dynamic sequences, scoped to the outreach performed by the user who owns the API key (messages and invitations sent by other members of the workspace are not taken into account).

Field	Type	Description
`lastActivityAt`	ISO-8601 string \| `null`	Date of the most recent outreach event: message sent, LinkedIn invitation sent or accepted, or reply received. `null` when the candidate was never contacted.
`lastActivityDirection`	`INBOUND` \| `OUTBOUND` \| `null`	`INBOUND` when the latest event comes from the talent (reply, accepted invitation), `OUTBOUND` when it comes from the API key owner (message or invitation sent). `null` when the candidate was never contacted.
`lastActivityChannel`	`LINKEDIN` \| `WHATSAPP` \| `EMAIL` \| `SMS` \| `null`	Channel of that latest event. `null` when the candidate was never contacted.
`lastActivityContent`	string \| `null`	Text of that latest event when it is a sent or received message. `null` when the candidate was never contacted, when the latest event is a LinkedIn invitation sent or accepted (Kalent does not store the invitation note), or when the message body is empty. Email subject is not included.
`replyStatus`	`REPLIED` \| `NO_REPLY` \| `NOT_CONTACTED`	`REPLIED` as soon as at least one reply was received on any channel, `NO_REPLY` when you contacted the talent without any reply, `NOT_CONTACTED` when no outreach happened.

replyStatus stays REPLIED even if you sent a follow-up after the talent replied (lastActivityDirection then becomes OUTBOUND). An accepted LinkedIn invitation counts as an inbound activity but not as a reply.

{
  "success": true,
  "data": {
    "candidate": {
      "id": "candidate_123",
      "statusHandle": "CONTACTED",
      "createdAt": "2026-05-19T09:00:00.000Z",
      "sourcingId": "sourcing_123",
      "talentId": "talent_123"
    },
    "talent": {
      "id": "talent_123",
      "firstname": "Grace",
      "lastname": "Hopper",
      "emails": ["grace@example.com"],
      "phones": [],
      "contactsLoading": { "email": false, "phone": false }
    },
    "lastActivityAt": "2026-05-21T14:32:00.000Z",
    "lastActivityDirection": "INBOUND",
    "lastActivityChannel": "LINKEDIN",
    "lastActivityContent": "Yes, I am interested.",
    "replyStatus": "REPLIED"
  }
}

Errors

Code	HTTP
`not_found`	404
`internal_error`	500

curl -X GET https://app.kalent.ai/api/v1/candidates/CANDIDATE_ID \
  -H "x-api-key: YOUR_API_KEY"

Get candidate

curl --request GET \
  --url https://app.kalent.ai/api/v1/candidates/{candidateId} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://app.kalent.ai/api/v1/candidates/{candidateId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.kalent.ai/api/v1/candidates/{candidateId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.kalent.ai/api/v1/candidates/{candidateId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.kalent.ai/api/v1/candidates/{candidateId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

Getting Started

Sourcing

Candidates

Sequences

First time? Set up Authentication

Path parameters

Response

Outreach activity

Errors

First time? Set up Authentication

​Path parameters

​Response

​Outreach activity

​Errors

Path parameters

Response

Outreach activity

Errors