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

Documentation Index

Fetch the complete documentation index at: https://docs.kalent.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
sourcingId
string
required
Sourcing id in the authenticated workspace.

​
Query parameters

​
pageIndex
integer
default:"0"
Zero-based page index.
​
pageSize
integer
default:"25"
Page size (max 50).
​
search
string
Free-text search on candidate/talent fields.
​
statusHandle
string
Repeatable status filter. When omitted, defaults to all statuses except NOT_RETAINED.
​
location
string
Repeatable city filter.
​
jobTitle
string
Repeatable job title filter.
​
currentCompany
string
Repeatable current company filter.
​
sortField
string
One of name, companyName, statusHandle, city, jobTitle, userRating, contacts, createdAt, history.
​
sortOrder
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

CodeHTTP
validation_error400
not_found404
internal_error500
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"