List candidates

GET

sourcings

{sourcingId}

candidates

List candidates

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

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

fetch('https://app.kalent.ai/api/v1/sourcings/{sourcingId}/candidates', 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/sourcings/{sourcingId}/candidates",
  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/sourcings/{sourcingId}/candidates"

	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/sourcings/{sourcingId}/candidates")

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 candidates for a sourcing using the same pagination, filters, and ordering as the Kalent candidates table.

Path parameters

string

required

Sourcing id in the authenticated workspace.

Query parameters

integer

default:"0"

Zero-based page index.

integer

default:"25"

Page size (max 50).

string

Free-text search on candidate/talent fields.

string

Repeatable status filter. When omitted, defaults to all statuses except NOT_RETAINED.

string

Repeatable city filter.

string

Repeatable job title filter.

string

Repeatable current company filter.

string

One of name, companyName, statusHandle, city, jobTitle, userRating, contacts, createdAt, history.history is not a true activity sort: the page is selected by talent creation date (talent.createdAt, in the requested sortOrder), then the candidates of that page are re-ordered in memory by their latest outreach activity (with desc, candidates without any activity come first, then the most recent activity first). To find who replied, read replyStatus on each item rather than relying on this sort.

string

asc or desc.

Response

When success is true, data contains:

candidates — list of { candidate, talent, lastActivityAt, lastActivityDirection, lastActivityChannel, lastActivityContent, replyStatus } summaries:
- candidate.id
- candidate.statusHandle
- candidate.createdAt
- candidate.sourcingId
- candidate.talentId
- talent.id
- talent.firstname
- talent.lastname
- talent.jobTitle
- talent.city
- talent.linkedinUrl
- lastActivityAt, lastActivityDirection, lastActivityChannel, lastActivityContent, replyStatus — see Outreach activity
pagination — pageIndex, pageSize, total, hasNextPage

Outreach activity

Each item carries the latest outreach activity between the talent and the user who owns the API key, aggregated across every channel (LinkedIn, email, WhatsApp, SMS) and across legacy and dynamic sequences. This is the same scope as the candidates table this user sees in Kalent: 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": {
    "candidates": [
      {
        "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",
          "jobTitle": "Software Engineer",
          "city": "Paris",
          "linkedinUrl": "https://www.linkedin.com/in/example"
        },
        "lastActivityAt": "2026-05-21T14:32:00.000Z",
        "lastActivityDirection": "INBOUND",
        "lastActivityChannel": "LINKEDIN",
        "lastActivityContent": "Yes, I am interested.",
        "replyStatus": "REPLIED"
      }
    ],
    "pagination": {
      "pageIndex": 0,
      "pageSize": 25,
      "total": 1,
      "hasNextPage": false
    }
  }
}

Errors

Code	HTTP
`validation_error`	400
`not_found`	404
`internal_error`	500

curl -G "https://app.kalent.ai/api/v1/sourcings/SOURCING_ID/candidates" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "pageIndex=0" \
  --data-urlencode "pageSize=25"

List candidates

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

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

fetch('https://app.kalent.ai/api/v1/sourcings/{sourcingId}/candidates', 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/sourcings/{sourcingId}/candidates",
  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/sourcings/{sourcingId}/candidates"

	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/sourcings/{sourcingId}/candidates")

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

Query parameters

Response

Outreach activity

Errors

First time? Set up Authentication

​Path parameters

​Query parameters

​Response

​Outreach activity

​Errors

Path parameters

Query parameters

Response

Outreach activity

Errors