2.2. Parameters
2.2 Parameters
Before submitting any job data to our application, you must ensure that it matches our schema and will validate completely. Although the user will be prompted during the posting process to correct any invalid job parameters, this should not be used to supplement a lack of validation in your ATS.
Please use the following definitions, regular expressions and notes to ensure that your ATS fulfills our requirements. Note that all regular expressions are Perl compatible, or PCRE. Also note that all values are trimmed of leading and trailing whitespace before being validated.
- requisition_number (required)
-
The primary user-defined job identifier unique to each job/user.
Validated by regex:
/^[A-Z0-9a-z-_ ]{1,255}$/ - io_number (optional)
-
A secondary identifier sometimes used by media agencies or ATSs for tracking.
Validated by regex:
/^[A-Z0-9a-z-_ \.&]{0,255}$/ - company_name (required*)
-
Company name.
Validated by regex:
/^(.){1,255}$/ - company_description_en (optional)
-
Company description. Appears above Description and Required Skills when the board does not provide a specific field.
Validated by regex:
/^.*$/m
- company_division (optional)
-
Company division.
Validated by regex:
/^(.){0,255}$/ - company_department (optional)
-
Company department.
Validated by regex:
/^(.){0,255}$/ - recruiter_org (optional)
-
Recruiter organization. For internal use only.
Validated by regex:
/^(.){0,255}$/ - recruiter_name (required*)
-
Recruiter name. For internal use only.
Validated by regex:
/^(.){1,255}$/ - recruiter_email (required*)
-
Recruiter email. For internal use only.
Validated by regex:
/^[^[:space:]@]{1,100}@[[:alnum:]_\.\-]{1,128}\.[[:alnum:]]{2,4}$/ - company_streetaddress (optional)
-
Company street address. For internal use only.
Validated by regex:
/^.{1,255}$/m - company_city (optional)
-
Company city. For internal use only.
Validated by regex:
/^(.){1,255}$/ - company_stateprovince (optional)
-
Company state/province. For internal use only.
Validated against the state/province enumeration.
- company_postalcode (optional)
-
Company postal code. For internal use only.
Validated by regex:
/^[A-Z0-9- ]{1,255}$/ - company_country (optional)
-
Company country. For internal use only.
Validated against the country enumeration.
- company_phone (optional)
-
Company phone. For internal use only.
Validated by regex:
/^[0-9]{1,255}$/ - company_fax (optional)
-
Company fax. For internal use only.
Validated by regex:
/^[0-9]{1,255}$/ - location_country (required)
-
Job country.
Validated against the country enumeration.
- location_city (required)
-
Job city.
Validated by regex:
/^(.){1,255}$/< - location_postalcode (optional)
-
Job postal code.
if no location_postalcode value is sent for a US-based posting, an arbitrary USPS postal code value will be assigned to the job based on the location_city/location_stateprovince combination. For example; if the job location is Chicago, IL -- 60667 could be used for one job while 60652 is assigned to the next. Valid values for US locations are 5 digits only; +4 suffixes are not allowed.
Otherwise, validated by regex:/^[A-Z0-9- ]{0,255}$/ - location_us_areacode (optional)
-
Job US area code.
Validated by regex:
/^([0-9]{3})?$/ - location_stateprovince (required)
-
Job state/province.
Validated against the state/province enumeration.
- title_en (required)
-
Job title.
Validated by regex:
/^(.){1,500}$/
- classification_type (required)
-
Job type classification.
Validated against the classification type enumeration.
- classification_time (required)
-
Job time classification.
Validated against the classification time enumeration.
- start_date (optional)
-
Job start date for temporary or contract positions.
Validated by regex:
/^(20[0-9][0-9]-[0-1][0-9]-[0-3][0-9])?$/
- end_date (optional)
-
Job end date for temporary or contract positions.
Validated by regex:
/^(20[0-9][0-9]-[0-1][0-9]-[0-3][0-9])?$/
- compensation_type (optional)
-
Compensation type.
Validated against the compensation type enumeration.
- compensation_currency (optional)
-
Compensation currency.
Validated against the compensation currency enumeration.
- compensation_amount (optional)
-
Compensation amount. This value takes precedence over range values â" when given, both the compensation_range_min and compensation_range_max fields are discarded.
Validated by regex:
/^([0-9]{1,10}|[0-9]{1,7}\.[0-9][0-9])?$/ - compensation_range_min (optional)
-
Compensation minimum.
Validated by regex:
/^([0-9]{1,10}|[0-9]{1,7}\.[0-9][0-9])?$/ - compensation_range_max (optional)
-
Compensation maximum.
Validated by regex:
/^([0-9]{1,10}|[0-9]{1,7}\.[0-9][0-9])?$/ - travel_percentage (optional)
-
Travel percentage.
Validated by regex:
/^([0-9]|[0-9][0-9]|100)?$/
- telecommute_percentage (optional)
-
Telecommute percentage.
Validated by regex:
/^([0-9]|[0-9][0-9]|100)?$/
- function (required)
-
Job function code.
Validated against the function enumeration.
- industry (required*)
-
Job industry code.
Validated against the industry enumeration.
- skills_en (required)
-
Description of required skills.
Validated by regex:
/^.+$/m
- education (optional)
-
Description of education requirements.
Validated against the education enumeration.
- description_en (required)
-
Description of the job position.
Validated by regex:
/^.+$/m
- benefits_en (optional)
-
Description of job benefits.
Validated by regex:
/^.*$/m
- contact_name (required*)
-
Job contact name. For internal use only.
Validated by regex:
/^(.){1,255}$/ - contact_email (required*)
-
Job contact email. For internal use only.
Validated by regex:
/^[^[:space:]@]{1,100}@[[:alnum:]_\.\-]{1,128}\.[[:alnum:]]{2,4}$/ - candidate_response_url (required)
-
Candidate response URL.
Validated by regex:
/^((http|https):\/\/.{1,128}\..{1,65399})?$/ - candidate_response_email (required*)
-
Candidate response email.
Validated by regex:
/^[^[:space:]@]{1,100}@[[:alnum:]_\.\-]{1,128}\.[[:alnum:]]{2,4}$/
* Field is required, but can default from eQuest posting account profile. A passed value will override any value stored in the account profile.