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>'

import requests

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

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.get("https://app.kalent.ai/api/v1/sourcings/{sourcingId}/candidates")
  .header("x-api-key", "<api-key>")
  .asString();

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.

string

asc or desc.

Response

When success is true, data contains:

candidates — list of { candidate, talent } summaries:
- candidate.id
- candidate.statusHandle
- candidate.createdAt
- candidate.sourcingId
- candidate.talentId
- talent.id
- talent.firstname
- talent.lastname
- talent.jobTitle
- talent.city
- talent.linkedinUrl
pagination — pageIndex, pageSize, total, hasNextPage

{
  "success": true,
  "data": {
    "candidates": [
      {
        "candidate": {
          "id": "candidate_123",
          "statusHandle": "TO_BE_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"
        }
      }
    ],
    "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"

Get candidateFetch a candidate with secured talent profile and contact loading flags.

List candidates

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

import requests

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

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.get("https://app.kalent.ai/api/v1/sourcings/{sourcingId}/candidates")
  .header("x-api-key", "<api-key>")
  .asString();

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

Search

Sourcing & candidates

LinkedIn contact enrichment

First time? Set up Authentication

Path parameters

Query parameters

Response

Errors

First time? Set up Authentication

​Path parameters

​Query parameters

​Response

​Errors

Path parameters

Query parameters

Response

Errors