Skip to navigation

Get Candidate Details

View as Markdown

GET /sourcing-session/candidate/:candidateId/details

Returns the full candidate profile (work history, education, skills, summary, etc.) within the context of a given session.

Path Parameters

NameTypeDescription
candidateIdstringCandidate id — the _id returned by Get Profiles for Session.

Query Parameters

NameTypeRequiredDescription
sessionIdstringyesThe session this candidate belongs to.

Headers

KeyValue
x-fj-api-keyfjk_

Response (200)

{
"statusCode": 200,
"data": {
"candidate": {
"_id": "<CANDIDATE_ID>",
"name": "Roshni Sabhwani",
"headline": "Digital Specialist Engineer at Infosys",
"summary": "Results-driven .NET developer with 4 years of experience...",
"flagship_profile_url": "https://www.linkedin.com/in/roshni-sabhwani-...",
"region": "Pune District, Maharashtra, India",
"years_of_experience_raw": 4,
"skills": ["C#", "ASP.NET MVC", ".NET Framework"],
"current_employers": [
{
"name": "Infosys",
"title": ".NET Developer",
"employment_type": "Full-time",
"years_at_company": "3 to 5 years"
}
],
"education_background": [
{
"degree_name": "Bachelor of Engineering - BE",
"field_of_study": "Electronics and Telecommunications",
"institute_name": "G.H. Raisoni College of Engineering, Nagpur"
}
]
},
"profileAnalysis": {
"starRating": 5,
"starLabel": "excellent",
"recommendation": "Strong fit for .NET development roles. 5/5"
}
},
"message": "Candidate details fetched successfully",
"status": "SUCCESS"
}

cURL

Replace fjk_YOUR_API_KEY_HERE, , and , then paste and run:

curl "https://prod.api.futurejobs.ai/api/v1/wl/sourcing-session/candidate/<CANDIDATE_ID>/details?sessionId=<SESSION_ID>" \
-H "x-fj-api-key: fjk_YOUR_API_KEY_HERE"

Errors

  • 401 Unauthorized

  • 404 Not Found — candidate or session not found.

Authentication

x-fj-api-keystring
API Key authentication via header

Query parameters

sessionIdstringOptional

Response headers

X-Powered-BystringOptional
X-Request-IdstringOptional
Access-Control-Allow-CredentialsstringOptional
RateLimit-PolicystringOptional
RateLimit-LimitstringOptional
RateLimit-RemainingstringOptional
RateLimit-ResetstringOptional
ETagstringOptional

Response

OK
statusCodeinteger
dataobject
messagestring
statusstring