Get a candidate profile
Returns the full profile of a candidate, including work experience, education, skills, languages, and certifications. Requires scope: `candidates:read`
Returns the full profile of a candidate, including work experience, education, skills, languages, and certifications.
Requires scope: candidates:read
Authorization
ApiKeyAuth API key issued by Jobiflow. Pass it in the X-API-Key request header.
Create keys via the company dashboard (Settings → API Keys) or via POST /settings/api-keys.
In: header
Path Parameters
UUID of the jobseeker / candidate.
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/public/v1/candidates/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"firstName": "string",
"lastName": "string",
"headline": "string",
"bio": "string",
"city": "string",
"country": "string",
"desiredJobTypes": "string",
"remotePreference": true,
"phone": "string",
"email": "user@example.com",
"skills": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"skillName": {
"value": "string",
"original": "string",
"sourceLanguage": "en",
"translated": true,
"translationType": "AI"
},
"skillLevel": "BEGINNER",
"yearsOfExperience": 0
}
],
"experiences": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"jobTitle": {
"value": "string",
"original": "string",
"sourceLanguage": "en",
"translated": true,
"translationType": "AI"
},
"companyName": "string",
"startDate": "2019-08-24",
"endDate": "2019-08-24",
"description": {
"value": "string",
"original": "string",
"sourceLanguage": "en",
"translated": true,
"translationType": "AI"
},
"positionType": "FULL_TIME"
}
],
"educations": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"institution": "Technical University of Munich",
"degree": "NONE",
"fieldOfStudy": {
"value": "string",
"original": "string",
"sourceLanguage": "en",
"translated": true,
"translationType": "AI"
},
"startDate": "2019-08-24",
"endDate": "2019-08-24",
"description": {
"value": "string",
"original": "string",
"sourceLanguage": "en",
"translated": true,
"translationType": "AI"
}
}
],
"languages": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"language": "German",
"proficiencyLevel": "A1"
}
],
"certifications": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"certName": {
"value": "string",
"original": "string",
"sourceLanguage": "en",
"translated": true,
"translationType": "AI"
},
"issuer": "AWS",
"issueDate": "2019-08-24",
"expiryDate": "2019-08-24",
"credentialUrl": "http://example.com"
}
]
}{
"status": 401,
"error": "UNAUTHORIZED",
"message": "Invalid or missing API key",
"timestamp": "2026-05-17T12:00:00Z",
"path": "/public/v1/job-listings"
}{
"status": 403,
"error": "FORBIDDEN",
"message": "Scope 'jobs:write' is required",
"timestamp": "2026-05-17T12:00:00Z",
"path": "/public/v1/job-listings"
}{
"status": 404,
"error": "NOT_FOUND",
"message": "Job listing not found",
"timestamp": "2026-05-17T12:00:00Z",
"path": "/public/v1/job-listings/00000000-0000-0000-0000-000000000000"
}Search candidates GET
Full-text and geo-filtered search across Jobiflow candidate profiles that have opted in to recruiter visibility. Requires scope: `candidates:read`
Import a candidate POST
Adds an external candidate into your company's pipeline without them having a Jobiflow account. Imported candidates are only visible to your company. Requires scope: `candidates:write`