Universal Schema
TypeScript definitions and normalization rules for StandardJob.
ATS SDK normalizes raw provider responses into a canonical, opinionated StandardJob object.
Type Definition
export type AtsProvider =
| "greenhouse"
| "ashby"
| "lever"
| "workday"
| "smartrecruiters"
| "workable"
| "recruitee"
| "breezy"
| "bamboohr"
| "rippling"
| "personio";
export type Workplace = "remote" | "hybrid" | "onsite" | "unknown";
export type EmploymentType =
"full-time" | "part-time" | "contract" | "internship";Prop
Type
Normalization Guarantees
- Provider-Agnostic Source Object: The
sourcefield explicitly identifies{ provider, id }, making cross-ATS aggregation clean and indexable. - Deterministic Workplace Classification: Automatic parsing of remote, hybrid, and onsite tags in titles, locations, and metadata into lowercase enum values (
remote,hybrid,onsite, orunknown). - Structured Compensation: Normalizes salary ranges into
salaryMin,salaryMax,salaryCurrency, andsalaryIntervalalongside human-readablesalary. - Lossless
rawpayload: The complete upstream API response is always preserved onjob.rawfor custom field extraction.
Application Form Schema
When extracting questions and application requirements via getForm(jobId), ATS SDK normalizes form structures into AtsFormResult and AtsFormField.
See the Application Forms guide for comprehensive usage details.
AtsFormResult
Prop
Type
AtsFormField
Prop
Type