Candidate Profile Schema

When RAISE successfully processes a resume, it publishes a CandidateProfileCreated event to the SQS output queue and/or stores it in DynamoDB, depending on your output target configuration.

This page documents the complete schema of that event.

Event Envelope

Field	Type	Required	Description
id	string (uuid)	✅	Unique identifier for this event
fileName	string	✅	The name of the source resume file (e.g. resumes/john-doe.pdf)
timestamp	string (date-time)	✅	ISO 8601 date-time when the event was published
analysisResult.candidateProfile	object	✅	The structured candidate profile extracted from the resume

Candidate Profile Fields

Required Fields

Field	Type	Description
fullName	string	The candidate's full name
email	string (email)	The candidate's email address
workExperience	array	Employment history — see Work Experience
education	array	Educational background — see Education

Optional Fields

Field	Type	Description
phoneNumber	string	Contact phone number
location	string	Geographic location of the candidate
professionalSummary	string	Summary of the candidate's professional background
skills	array	List of skills — see Skills
certifications	array	List of certifications — see Certifications

Nested Objects

Work Experience

Each entry in the workExperience array contains:

Field	Type	Required	Description
companyName	string	✅	Name of the employer
position	string	✅	Job title or role
startDate	string	✅	Start date of employment
endDate	string	No	End date of employment
isCurrentPosition	boolean	No	true if this is the candidate's current role
responsibilities	array of strings	✅	List of responsibilities in this role

Education

Each entry in the education array contains:

Field	Type	Required	Description
institution	string	✅	Name of the educational institution
qualification	string	✅	Degree or qualification obtained
fieldOfStudy	string	No	Major or field of study
year	string	No	Year the qualification was attained

Skills

Each entry in the skills array contains:

Field	Type	Required	Description
skill	string	✅	A specific skill or competency

Certifications

Each entry in the certifications array contains:

Field	Type	Required	Description
certification	string	✅	Name of the certification
year	string	No	Year the certification was attained

Full Example

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "fileName": "resumes/jane-smith.pdf",
  "timestamp": "2026-03-29T08:30:00.000Z",
  "analysisResult": {
    "candidateProfile": {
      "fullName": "Jane Smith",
      "email": "jane.smith@example.com",
      "phoneNumber": "+27 82 123 4567",
      "location": "Johannesburg, South Africa",
      "professionalSummary": "Senior software engineer with 8 years of experience building cloud-native applications on AWS.",
      "workExperience": [
        {
          "companyName": "Acme Financial Services",
          "position": "Senior Software Engineer",
          "startDate": "2021-03",
          "isCurrentPosition": true,
          "responsibilities": [
            "Designed and built microservices on AWS Lambda and ECS",
            "Led a team of 4 engineers across two product squads",
            "Reduced API response times by 40% through caching improvements"
          ]
        },
        {
          "companyName": "Tech Startup Ltd",
          "position": "Software Engineer",
          "startDate": "2018-06",
          "endDate": "2021-02",
          "isCurrentPosition": false,
          "responsibilities": [
            "Built RESTful APIs using Node.js and TypeScript",
            "Maintained CI/CD pipelines on GitHub Actions"
          ]
        }
      ],
      "education": [
        {
          "institution": "University of the Witwatersrand",
          "qualification": "BSc Computer Science",
          "fieldOfStudy": "Computer Science",
          "year": "2018"
        }
      ],
      "skills": [
        { "skill": "TypeScript" },
        { "skill": "AWS Lambda" },
        { "skill": "Node.js" },
        { "skill": "DynamoDB" }
      ],
      "certifications": [
        { "certification": "AWS Certified Solutions Architect – Associate", "year": "2022" },
        { "certification": "AWS Certified Developer – Associate", "year": "2023" }
      ]
    }
  }
}