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 |
| summary | string Default: "false" Enum: "true" "false" Generate an abstractive summary of the CV ( |
| classification | string Default: "false" Enum: "true" "false" Run BO&C and ESCO profession classification on work experiences ( |
{ "correlationId": "mijn-referentie-001", "language": "nl", "country": "NL" }
{- "metadata": {
- "metaCountry": "NL",
- "metaLanguage": "nl",
- "apiCountry": "NL",
- "apiExportLanguage": "en",
- "documentLanguage": "nl",
- "yearCVCreated": "2001",
- "yearCVParsed": "2025",
- "nlpProcessingTimeMS": "6573",
- "sqsWaitingTimeMS": "8421",
- "contentType": "application/pdf",
- "nrOfPages": "3",
- "pageDimensions": [
- {
- "pageHeight": "842.0",
- "pageNumber": "2",
- "pageWidth": "595.0"
}
], - "pdfVersion": "1.4",
- "ocr": "YES",
- "sourceFileName": "john_doe_cv.pdf",
- "dateCreated": "2025-05-20",
- "rawText": "John Doe\n123 Main St\nAmsterdam, NL\n\nProfile\nExperienced software engineer…",
- "correlationId": "a88ab71c-7653-4793-8907-420b3fd6696b",
}, - "personalData": {
- "firstName": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "prof. dr. ir. erik",
- "value": "Erik"
}, - "lastName": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Van Der Velde",
- "value": "van der Velde"
}, - "lastNamePrefix": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Van Der",
- "value": "van der"
}, - "lastNameBase": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "velde",
- "value": "Velde"
}, - "middleName": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "michael",
- "value": "Michael"
}, - "initials": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Michael E.H.",
- "value": "M.E.H."
}, - "fullName": "Michael Fox",
- "gender": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Man",
- "value": "male"
}, - "genderBasedOnFirstName": "ambig",
- "genderBasedOnHeadShotProbability": "0.0",
- "genderBasedOnHeadShot": "female",
- "maritalStatus": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "gehuwd",
- "value": "married"
}, - "dateOfBirth": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "13-12-1970",
- "value": "1970-12-13"
}, - "birthYear": "2005",
- "birthMonth": "3",
- "birthLocation": {
- "rawText": "Amsterdam, Netherlands",
- "city": "Gent",
- "state": "Noord-Holland",
- "country": "France",
- "countryCode": "FR",
- "pageNumber": "string",
- "boundingBox": "205 314 213 314",
- "formatted": "Gent, Oost-Vlaanderen, Vlaanderen, België",
- "village": "Eeklo"
}, - "nationality": "NL",
- "livingAddress": {
- "rawText": "Geranium, 66, 5382JM, Vinkel",
- "street": "Hoofdstraat",
- "houseNumber": "5A",
- "postalCode": "1000 AB",
- "city": "Eindhoven",
- "state": "Noord-Holland",
- "country": "France",
- "countryCode": "FR",
- "lat": "51.0535",
- "lon": "3.7187",
- "pageNumber": "string",
- "boundingBox": "205 314 213 314",
- "formatted": "99, Langestraat, Tuinwijk, Kruibeke, Beveren-Kruibeke-Zwijndrecht, Sint-Niklaas, Oost-Vlaanderen, Vlaanderen, 9150, België",
- "village": "Wilp-Achterhoek"
}, - "mobilePhoneNumbers": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "(06)224 17 250",
- "value": "+31 6 22417250"
}
], - "phoneNumbers": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "0317-616 308",
- "value": "+31 317 616 308"
}
], - "rawText": "string",
- "anonymizedTextLevel1": "Curriculum vitae\\\\n\\\\nNAAM **** *********\\\\nADRES ******** **, ******* Vinkel\\\\nE-MAIL ************************\\\\nGEBOREN ********** te 's-Gravenhage, Nederlandse nationaliteit\\\\nKWALITEITEN Analytisch, zelfstandig, aanpakker, empatisch en sociaal vaardig.\\\\n\\\\nTEL ****************",
- "anonymizedTextLevel2": "January 10, 2020\\\\n\\\\n******* *******\\\\nSenior Client Services Executive,\\\\nTransPerfect\\\\nI've been working with ***** closely\\\\nfor about 2 years. He is a problem-\\\\nsolver, honest and straight to the\\\\npoint. ***** is really good at\\\\nbalancing the professional demeanor\\\\nwith being friendly and open, making\\\\nthe clients trust him immediately.",
- "emailAddresses": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "hansolo@galaxy.com",
- "value": "hansolo@galaxy.com"
}
], - "age": "35"
}, - "socialMediaLinks": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "LinkedIn: https://www.linkedin.com/johndoe",
- "site": "LinkedIn",
}
], - "drivingLicenses": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "string",
- "value": "string"
}
], - "highestCompletedEducation": "WO-Bachelor",
- "highestCompletedInternationalEducation": "Bachelor",
- "highestCompletedEducationCompletionDate": "2020-05-01",
- "mostRecentEducation": "HBO-Bachelor",
- "highestEducation": "MBO-MBO3",
- "highestInternationalEducation": "Vocational Education",
- "careerStage": "JUNIOR",
- "yearsSinceCompletionOfHighestCompletedEducation": "7",
- "yearsOfRelevantWorkingExperience": "1",
- "monthsOfRelevantWorkingExperience": "17",
- "yearsOfWorkingExperience": "5",
- "monthsOfWorkingExperience": "63",
- "mostRecentJobTitle": "Bartender",
- "mostRecentEmployer": "Caradura",
- "summaryAbstractive": "string",
- "profileDescription": {
- "jobtitles": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "string",
- "value": "string"
}
], - "jobdiggerSkills": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Indesign",
- "value": "10089:Adobe InDesign"
}
], - "rawText": "string",
- "anonymizedTextLevel1": "**** *******\\nProfiel samenvatting\\nVia ervaringen opgedaan in zowel multinationals als lokale\\nondernemingen, ben ik geëvolueerd van een 'bits-en-bytes'\\npersoon naar iemand met inzichten in...",
- "anonymizedTextLevel2": "CURRICULUM VITAE\\nPROFESSIONELE DOELSTELLING\\nApotheker zelfstandig provisor of adjunct\\nBEROEPSERVARING\\nVARIA\\n\\nIk ben een extravert doelgericht stressbestendig persoon met veel empathie optimisme en\\nteamspirit\\nNieuwe uitdagingen en gedrevenheid in alles wat ik doe zijn mijn troeven....."
}, - "educations": [
- {
- "category": "FORMAL_EDUCATION",
- "institute": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "string",
- "value": "string"
}, - "course": "Computer Science",
- "diploma": "Master of Science",
- "certificate": "Heftruckcertificaat",
- "diplomaStatus": "completed",
- "startYear": "{rawText:September 2015,value:2015}",
- "endYear": "{rawText:June 2019,value:2019}",
- "jobdiggerSkills": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Indesign",
- "value": "10089:Adobe InDesign"
}
], - "rawText": "string",
- "anonymizedTextLevel1": "Opleidingen:\\n\\n2000-2002 Transport en logistiek(opleiding voor vrachtwagenchauffeur)\\n(diploma behaalt, en chauffeursdiploma en vrachtwagenrijbewijs\\nB-C-E)",
- "anonymizedTextLevel2": "EDUCATION\\n\\nmain subject sports training and coaching\\n\\n2015 - 2016 University of Ghent, Master of science in physical education and movement sciences -",
- "sequenceNr": "0",
- "location": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "string",
- "value": "string"
}, - "educationLevel": {
- "boundingBox": "205 314 213 314",
- "internationalEducationLevel": "Bachelor",
- "pageNumber": "3",
- "rawText": "Bachelor aan de HAN",
- "value": "HBO-Bachelor"
}, - "completed": "true"
}
], - "experiences": [
- {
- "startDate": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "13-12-1970",
- "value": "1970-12-13"
}, - "endDate": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "heden",
- "value": "2020-12-31"
}, - "numberOfMonths": "18",
- "category": "INTERNSHIP",
- "jobtitle": "{rawText: Software Engineer,value:Software Engineer}",
- "description": "Led a team of 5 in developing and launching the new mobile app, improving user engagement by 30%.",
- "professionClassification": {
- "escoCode": "a79170ad-0b7b-4697-864f-1748359aa10a",
- "escoVersion": "1.1",
- "escoLabel": "ICT product manager",
- "escoLabelLanguage": "en",
- "bocCode": "11297",
- "bocVersion": "24.2",
- "iscoCode": "2240"
}, - "organization": "{rawText:Acme Corp,value:Acme Corp}",
- "location": "{rawText:Gent, België,value:Gent, België}",
- "jobdiggerSkills": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Indesign",
- "value": "10089:Adobe InDesign"
}
], - "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string",
- "sequenceNr": "0"
}
], - "internships": [
- {
- "startDate": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "13-12-1970",
- "value": "1970-12-13"
}, - "endDate": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "heden",
- "value": "2020-12-31"
}, - "jobtitle": "{rawText: Software Engineer,value:Software Engineer}",
- "organization": "{rawText:Acme Corp,value:Acme Corp}",
- "location": "{rawText:Gent, België,value:Gent, België}",
- "jobdiggerSkills": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Indesign",
- "value": "10089:Adobe InDesign"
}
], - "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string",
- "sequenceNr": "0"
}
], - "recommendations": [
- {
- "startDate": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "13-12-1970",
- "value": "1970-12-13"
}, - "endDate": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "heden",
- "value": "2020-12-31"
}, - "initials": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Michael E.H.",
- "value": "M.E.H."
}, - "firstName": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "prof. dr. ir. erik",
- "value": "Erik"
}, - "middleName": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "michael",
- "value": "Michael"
}, - "lastName": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Van Der Velde",
- "value": "van der Velde"
}, - "gender": {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Man",
- "value": "male"
}, - "genderBasedOnFirstName": "ambig",
- "mobilePhoneNumbers": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "(06)224 17 250",
- "value": "+31 6 22417250"
}
], - "phoneNumbers": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "0317-616 308",
- "value": "+31 317 616 308"
}
], - "jobtitle": "{rawText: Software Engineer,value:Software Engineer}",
- "organization": "{rawText:Acme Corp,value:Acme Corp}",
- "location": "{rawText:Gent, België,value:Gent, België}",
- "jobdiggerSkills": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Indesign",
- "value": "10089:Adobe InDesign"
}
], - "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string",
- "sequenceNr": "0",
- "emailAddresses": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "hansolo@galaxy.com",
- "value": "hansolo@galaxy.com"
}
]
}
], - "publications": [
- {
- "startYear": "{rawText:1998–2000,value:1998}",
- "endYear": "{rawText:1998–2000,value:2000}",
- "rawText": "string",
- "anonymizedTextLevel1": "string",
- "anonymizedTextLevel2": "string",
- "sequenceNr": "0"
}
], - "hobbies": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "string",
- "value": "string"
}
], - "languageSkills": [
- {
- "boundingBox": "205 314 213 314",
- "cefr": "B2",
- "level": "4",
- "pageNumber": "3",
- "rawText": "string",
- "value": "string"
}
], - "jobdiggerSkills": [
- {
- "boundingBox": "205 314 213 314",
- "pageNumber": "3",
- "rawText": "Indesign",
- "value": "10089:Adobe InDesign"
}
], - "headShotBase64Encoded": "string"
}