Skip to main content

​
BusinessContextDto Schema

The BusinessContextDto contains information about the business context for the new job position the applicant is applying for.

​
Supported Fields

FieldRequiredTypeRules and behavior
entityNameYesstringEmployer the candidate is applying to. Example: "Apple".
appliedJobTitleYesstringJob title the candidate is applying for. Example: "Senior Software Engineer".
worksiteCityYesstringCity of the candidate’s proposed worksite. Example: "San Francisco".
worksiteStateYesstringTwo-letter state code for the proposed worksite. Example: "CA".
proposedSalaryYesnumberCandidate’s proposed salary. Must be a positive number.
positionLevelNostringCandidate’s proposed job level. Allowed values: EXECUTIVE, STANDARD, SENSITIVE.
securityClearanceRequiredNobooleanWhether the role requires security clearance.
industrySectorNostringIndustry sector for regulatory context. Example: "TECHNOLOGY".

​
Complete Example

{
  "entityName": "Apple",
  "appliedJobTitle": "Senior Software Engineer",
  "worksiteCity": "San Francisco",
  "worksiteState": "CA",
  "proposedSalary": 100000,
  "positionLevel": "STANDARD",
  "securityClearanceRequired": false,
  "industrySector": "TECHNOLOGY"
}

​
Validation Rules

  • State Format: worksiteState must be exactly 2 characters
  • Salary: proposedSalary must be a positive number
  • Position Level: Must be one of the allowed enum values if provided