This article documents the Radancy Standard Applicant Fields Model (API) used for applicant and application data integrations with an Applicant Tracking System (ATS).
It is intended for technical customer contacts and integration stakeholders who need to understand:
- Which applicant and application fields are supported
- Which fields are required versus recommended or optional
- How data is structured and refreshed within Radancy CRM
This article is a reference guide and does not describe ATS‑specific configuration steps or field‑mapping instructions.
Field Requirement Levels
Each field in the applicant integration model is categorized as one of the following:
- Required – Must be provided for the integration to function correctly
- Recommended – Enables enhanced functionality such as matching, search, and segmentation
- Optional – Not required, but useful when available
Additional indicators:
- Trigger – Candidate profile fields update only on new application or application status change
- Resume Parse – Some fields may be automatically populated via resume parsing, when supported
| Field Name | Description | Required | Editable | *Trigger |
| emailAddress | String. Email address of candidate | Required | No | |
| importCreationDate | DateTime | Optional | ||
| importUpdateDate | DateTime | Optional | ||
| atsProfileUpdateDate | DateTime | Required | ||
| applicantId | String. The unique id of candidate from ATS | Required | No | |
| startDate | Nullable DateTime. Applicant’s start date (Hired state) | Required | ||
| firstName | String | Recommended | ||
| lastName | String | Recommended | ||
| resume | Attachment. **Resume parse | Recommended | ||
| skills | String. Or derived through resume parse | Recommended | ||
| Address | Concrete object type | |||
| country | String (Full name or ISO 2-Digit Alpha Country Code. If ISO 3-Digit Alpha Country Code, not able to import to CRM) | Optional | ||
| state | String (Full name) | Optional | ||
| stateCode | String (2-Digit state code. State or StateCode, provide either of them) | Optional | ||
| city | String | Optional | ||
| address | String | Optional | ||
| address2 | String | Optional | ||
| zipcode | String | Optional | ||
| Phone Number(s) | Array Type | |||
| Type | Integer. Enum stands for phone type (1: HomePhone, 2: MobilePhone, 3: OfficePhone) | Optional | ||
| Value | String. Phone number | Optional | ||
| Education(s) | Array Type | |||
| schoolName | String | Optional | ||
| Major | String | Optional | ||
| degreeObtained | String | Optional | ||
| startMonth | Nullable integer | Optional | ||
| startYear | Nullable integer | Optional | ||
| endMonth | Nullable integer | Optional | ||
| endYear | Nullable integer | Optional | ||
| IsCurrent | Boolean. Is currently working or studying here? | Optional | ||
| Work Experience(s) | Array Type | |||
| companyName | String | Optional | ||
| title | String | Optional | ||
| workDescription | String | Optional | ||
| startMonth | Nullable integer | Optional | ||
| startYear | Nullable integer | Optional | ||
| endMonth | Nullable integer | Optional | ||
| endYear | Nullable integer | Optional | ||
| IsCurrent | Boolean. Is currently working or studying here? | Optional | ||
| Tags | Array Type | |||
| tag | String. Candidate tag set in ATS profile. Include Tag ID attribute if available. | Optional | ||
| Application(s) | Array Type | |||
| applicationId | String. Job application id from ATS | Required | No | x |
| reqId | String. Job requisition id | Required | ||
| title | String. Job title | Required | ||
| applicantId | String. The unique id of candidate from ATS | Required | ||
| importCreationDate | DateTime | Optional | ||
| importUpdateDate | DateTime | Optional | ||
| atsUpdateDate | DateTime. Job application update time from ATS | Required | ||
| status | Application Object type. Saves the current status of this application | |||
| mainStatus | String. Main status of current application | Required | x | |
| subStatus | String. Sub status of current application | Required | x | |
| updated | DateTime. Job application update time from ATS | Required | ||
| Profile | Application Object type. Properties described below in "Profile" cells | |||
| applicationDate | Nullable DateTime | Optional | ||
| hireDate | Nullable DateTime | Optional | ||
| startDate | Nullable DateTime | Optional | ||
| ethnicity | String | Optional | ||
| gender | String | Optional | ||
| atsSource | String | Optional | ||
| jobInformation | Application Object type. Saves job information of this application. | |||
| businessUnit | String | Optional | ||
| department | String | Optional | ||
| function | String | Optional | ||
| positionLevel | String | Optional | ||
| jobCategory | String | Optional | ||
| jobCity | String | Optional | ||
| jobState | String | Optional | ||
| jobPostalCode | String | Optional | ||
| jobRegion | String | Optional | ||
| jobCountry | String | Optional | ||
| statusHistory | Application Object type. List of all previous Status types. | |||
| mainStatus | String | Recommended | ||
| subStatus | String | Recommended | ||
| updated | DateTime | Recommended |
Formatting Requirements
- DateTime:
YYYY-MM-DDThh:mm:ss- Example:
2021-02-20T04:05:27
- Example:
- Phone Numbers: Multiple formats allowed; validated during UAT