Get a potential candidate
Fetch one sourced lead in the curated v1 shape. Scope: sourcing:read.
GET
/api/v1/sourcing/{id}
🔒 API keyFetches a single potential candidate (lead). Scope: sourcing:read. A lead the key cannot see returns 404 (no existence leak).
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | The 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
| Status | Meaning |
|---|---|
200 | Success. |
401 | No valid API key. |
403 | insufficient_scope — the key lacks sourcing:read. |
404 | Not found, or not visible to the key. |
429 | Rate limit exceeded. |