Download OpenAPI specification:
API for uploading and processing CV files (PDF, DOCX, DOC, PPT, PPTX, TXT, HTML, RTF, JPG, PNG, XLS, XLSX, ODT, WPS, MSG, WPD). The file is analysed and the extracted data is returned as JSON.
Supports three Content-Types: - multipart/form-data with a binary file - multipart/form-data with a base64-encoded file - application/json with a base64-encoded file
Limits: maximum file size is 5 MB. Only the first 5 pages are processed; additional pages are accepted but ignored.
| file required | string <binary> The CV file (supported formats: PDF, DOCX, DOC, PPT, PPTX, TXT, HTML, RTF, JPG, PNG, XLS, XLSX, ODT, WPS, MSG, WPD) |
| correlationId required | string Unique identifier for this request (your own reference) |
| language | string Default: "nl" Enum: "nl" "en" "de" "fr" Language of the CV |
| country | string Default: "NL" Country of origin |
{ "correlationId": "mijn-referentie-001", "language": "nl", "country": "NL" }
{- "metadata": {
- "metaCountry": "NL",
- "metaLanguage": "nl",
- "apiCountry": "NL",
- "apiExportLanguage": "en",
- "documentLanguage": "nl",
- "yearCVCreated": 2020,
- "yearCVParsed": 2025,
- "nlpProcessingTimeMS": "6573",
- "contentType": "application/pdf",
- "nrOfPages": 1,
- "pageDimensions": [
- {
- "pageNumber": "string",
- "pageWidth": "string",
- "pageHeight": "string"
}
], - "pdfVersion": "1.4",
- "ocr": "YES",
- "sourceFileName": "john_doe_cv.pdf",
- "dateCreated": "2019-08-24",
- "rawText": "string",
- "correlationId": "string",
- "pdfFileTempLink": "string"
}, - "personalData": {
- "firstName": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "lastName": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "middleName": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "initials": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "fullName": "string",
- "gender": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "genderBasedOnFirstName": "male",
- "genderBasedOnHeadShot": "male",
- "genderBasedOnHeadShotProbability": 1,
- "maritalStatus": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "dateOfBirth": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "birthLocation": {
- "rawText": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "countryCode": "string",
- "formatted": "string",
- "village": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "nationality": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "livingAddress": {
- "rawText": "string",
- "street": "string",
- "houseNumber": "string",
- "postalCode": "string",
- "city": "string",
- "state": "string",
- "country": "string",
- "countryCode": "string",
- "lat": "string",
- "lon": "string",
- "formatted": "string",
- "village": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "mobilePhoneNumbers": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "phoneNumbers": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "emailAddresses": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "age": 0,
- "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string"
}, - "socialMediaLinks": [
- {
- "site": "string",
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "drivingLicenses": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "highestCompletedEducation": "string",
- "highestCompletedInternationalEducation": "string",
- "highestCompletedEducationCompletionDate": "2019-08-24",
- "mostRecentEducation": "string",
- "highestEducation": "string",
- "highestInternationalEducation": "string",
- "careerStage": "STUDENT",
- "yearsSinceCompletionOfHighestCompletedEducation": 0,
- "yearsOfRelevantWorkingExperience": 0,
- "monthsOfRelevantWorkingExperience": 0,
- "yearsOfWorkingExperience": 0,
- "monthsOfWorkingExperience": 0,
- "mostRecentJobTitle": "string",
- "mostRecentEmployer": "string",
- "summaryAbstractive": "string",
- "profileDescription": {
- "jobtitles": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "jobdiggerSkills": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string"
}, - "educations": [
- {
- "category": "FORMAL_EDUCATION",
- "institute": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "course": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "diploma": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "certificate": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "educationLevel": {
- "value": "string",
- "internationalEducationLevel": "Secondary Education",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "startYear": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "endYear": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "isCurrent": true,
- "diplomaStatus": "string",
- "completed": true,
- "location": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "jobdiggerSkills": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "sequenceNr": 0,
- "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string"
}
], - "experiences": [
- {
- "startDate": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "endDate": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "numberOfMonths": 0,
- "category": "SIDE_JOB",
- "isCurrent": true,
- "jobtitle": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "description": "string",
- "professionClassification": {
- "escoCode": "string",
- "escoVersion": "string",
- "escoLabel": "string",
- "escoLabelLanguage": "nl",
- "bocCode": "string",
- "bocVersion": "string",
- "iscoCode": "string"
}, - "organization": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "location": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "jobdiggerSkills": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "sequenceNr": 0,
- "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string"
}
], - "internships": [
- {
- "startDate": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "endDate": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "jobtitle": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "organization": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "location": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "jobdiggerSkills": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "sequenceNr": 0,
- "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string"
}
], - "recommendations": [
- {
- "startDate": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "endDate": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "firstName": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "middleName": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "lastName": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "gender": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "genderBasedOnFirstName": "string",
- "jobtitle": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "organization": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "location": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "mobilePhoneNumbers": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "phoneNumbers": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "emailAddresses": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "jobdiggerSkills": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "sequenceNr": 0,
- "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string"
}
], - "publications": [
- {
- "startYear": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "endYear": {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}, - "sequenceNr": 0,
- "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string"
}
], - "hobbies": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "languageSkills": [
- {
- "value": "string",
- "rawText": "string",
- "cefr": "A1",
- "level": 1,
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "jobdiggerSkills": [
- {
- "value": "string",
- "rawText": "string",
- "pageNumber": "string",
- "boundingBox": "string"
}
], - "headShotBase64Encoded": "string"
}