Skip to main content

Get a potential candidate

Fetch one sourced lead in the curated v1 shape. Scope: sourcing:read.

GET/api/v1/sourcing/{id} 🔒 API key

Fetches a single potential candidate (lead). Scope: sourcing:read. A lead the key cannot see returns 404 (no existence leak).

Path parameters

ParameterTypeDescription
idstringThe potential-candidate id.

Example request

curl https://app.talent-ray.com/api/v1/sourcing/pc_1 \
  -H "Authorization: Bearer tr_YOUR_KEY"

Response

200 OK — a single potential-candidate object (same shape as the items in List potential candidates).

Status codes

StatusMeaning
200Success.
401No valid API key.
403insufficient_scope — the key lacks sourcing:read.
404Not found, or not visible to the key.
429Rate limit exceeded.