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

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"