Get qualified search result

GET

talents

qualified

{castingId}

curl --request GET \
  --url https://app.kalent.ai/api/v1/search/talents/qualified/{castingId} \
  --header 'x-api-key: <api-key>'

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

fetch('https://app.kalent.ai/api/v1/search/talents/qualified/{castingId}', 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/search/talents/qualified/{castingId}",
  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/search/talents/qualified/{castingId}"

	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/search/talents/qualified/{castingId}")

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

{
  "success": true,
  "data": {
    "castingId": "<string>",
    "status": "<string>",
    "nextAction": "<string>",
    "canContinue": true,
    "scoringLanguage": "<string>",
    "counts": {},
    "creditsCharged": 123,
    "creditsRemaining": 123,
    "talents": [
      {
        "talentId": "<string>",
        "aiVerdict": "<string>",
        "scoring": {},
        "profile": {}
      }
    ],
    "nextPageCursor": "<string>"
  },
  "error": {
    "code": "<string>",
    "message": "<string>",
    "debugTrackingCode": "<string>"
  }
}

First time? Set up Authentication

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

Read a qualified search started with POST /v1/search/talents/qualified or POST /v1/search/talents/qualified/by-prompt. This endpoint only reads talents that already received a verdict. It never starts an analysis, never costs credits, and does not send the X-Api-Credits-Remaining header (only start, by-prompt, and continue do). Calls, waves, and credits are explained on the qualified search overview. To analyse new talents, call POST /v1/search/talents/qualified/{castingId}/continue. Follow nextAction:

`nextAction`	What to do
`wait`	A call is running. Poll again in 10–20 seconds, or wait for the end-of-call webhook.
`continue`	The call stopped and more matching talents exist. Call continue to authorise another call. It looks for `target.greens` new greens, up to `target.maxCredits`.
`retry`	The last wave failed. Call continue to retry it.
`done`	The talent pool is exhausted. Nothing more to analyse.

canContinue is kept for compatibility and equals nextAction === "continue".

Ordering

Talents are returned green first, then amber, then red. Within a verdict, they are in the order they were judged. Pagination follows the same order across pages.

Path

string

required

The castingId returned when the qualified search was started.

Query

string

Verdicts to return: one or more of green, amber, red. Repeat the parameter or separate values with commas (verdicts=green,amber). Default: all three. The filter changes only the talents array; counts and credits are unchanged.

string

nextPageCursor from a previous response. Omit it on the first page. A cursor is bound to the verdicts it was issued with; reusing it with a different filter returns validation_error.

number

default:"50"

Number of talents to return, from 1 to 100.

Response

boolean

Whether the request completed without errors.

object

Present when success is true.

Show data fields

string

Identifier of the qualified search.

string

One of running, can_continue, pool_exhausted, failed_retryable.

string

One of wait, continue, retry, done. Computed by Kalent from the state of the search.

boolean

true only when nextAction is continue.

string

Language of recap, criterion title, and criterion result for every talent of this search: en or fr. Resolved when the search started (from scoringLanguage on the start request, or from the language of the user who owns the API key) and fixed for the whole search. null for searches started before this field existed. See Scoring language.

object

Totals for the whole search, not only the current page or the verdicts filter: green, amber, and red. target.greens on start and continue is a quota for that call only; these counts stay cumulative.

number

Credits charged on this search so far, across all calls.

number

Credits the current call can still spend: the remaining budget of the call (target.maxCredits minus what its finished waves have charged), bounded by what your workspace can actually pay (credits already reserved for this call plus your available balance). 0 once the call is over. It can go back up while the call runs, because the balance is shared with your other calls and with talent search. To know what a call spent, read creditsCharged; do not subtract creditsRemaining from target.maxCredits. When nextAction is retry and the balance is empty, it is 0 and a continue answers 402 insufficient_api_credits until credits are added. Not part of the webhook payloads.

object[]

Qualified talents on this page, green first, then amber, then red.

Show talent fields

string

Talent identifier.

string

One of green, amber, or red.

object

Evaluation result for this talent, or null when none is available: recap and criterias, each criterion with title, result, status, evaluable, and references. recap, title, and result are written in scoringLanguage; quotes in references stay in the profile’s original language.

object

Profile fields as on POST /v1/search/talents. Talents that cannot be loaded are omitted from the array.

string

Pass this as cursor to load the next page with the same verdicts. null when there are no further talents.

object

Present when success is false.

Show error fields

string

One of: validation_error, casting_not_found, internal_error, plus the authentication codes documented in Authentication.

string

Human-readable error description. For a missing search the message is Casting not found.

string

Include this when contacting support.

HTTP status	Code	When
400	`validation_error`	Invalid `verdicts`, `pageSize`, or a `cursor` that does not match this search and filter
404	`casting_not_found`	Unknown `castingId` for this workspace
500	`internal_error`	Unexpected error

Example

curl "https://app.kalent.ai/api/v1/search/talents/qualified/CASTING_ID?verdicts=green&pageSize=50" \
  -H "x-api-key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "castingId": "3f9d2c1e-7b4a-4e8f-9c21-5d6a8b0e4f17",
    "status": "can_continue",
    "nextAction": "continue",
    "canContinue": true,
    "scoringLanguage": "en",
    "counts": { "green": 10, "amber": 4, "red": 6 },
    "creditsCharged": 40,
    "creditsRemaining": 0,
    "talents": [],
    "nextPageCursor": null
  }
}

Get qualified search result

curl --request GET \
  --url https://app.kalent.ai/api/v1/search/talents/qualified/{castingId} \
  --header 'x-api-key: <api-key>'

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

fetch('https://app.kalent.ai/api/v1/search/talents/qualified/{castingId}', 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/search/talents/qualified/{castingId}",
  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/search/talents/qualified/{castingId}"

	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/search/talents/qualified/{castingId}")

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

{
  "success": true,
  "data": {
    "castingId": "<string>",
    "status": "<string>",
    "nextAction": "<string>",
    "canContinue": true,
    "scoringLanguage": "<string>",
    "counts": {},
    "creditsCharged": 123,
    "creditsRemaining": 123,
    "talents": [
      {
        "talentId": "<string>",
        "aiVerdict": "<string>",
        "scoring": {},
        "profile": {}
      }
    ],
    "nextPageCursor": "<string>"
  },
  "error": {
    "code": "<string>",
    "message": "<string>",
    "debugTrackingCode": "<string>"
  }
}

Getting Started

Talent search

Qualified search

LinkedIn contact enrichment

Get qualified search result

First time? Set up Authentication

Ordering

Path

Query

Response

Example

First time? Set up Authentication

​Ordering

​Path

​Query

​Response

​Example

Ordering

Path

Query

Response

Example