Common Error Response ContentThe API can return the following example error responses. Note that messages should not be coded against since they can change. See the Apiary documentation for all response codes and content. When Request is Not AuthenticatedHTTP/1.1 401 Unauthorized
When API Operation is Not Permitted HTTP/1.1 403 Forbidden Content-Type:application/vnd.seek.advertisement-error+json; charset=utf-8; version=1
The response content will have message and errors fields with the following codes:InvalidValue
Invalid value ‘something’ in field ‘advertiserId’
RelationshipError
Your account does not have a relationship with Advertiser ‘1234’
Unknown
No operations are permitted with supplied access token
When Request Content Contains Invalid JSONHTTP/1.1 400 Bad RequestContent-Type: application/vnd.seek.advertisement-error+json;charset=utf-8; version=1
The response content will only have a message field indicating why the request content is invalid. Examples of error messages are:- After parsing a value an unexpected character was encountered: j. Path ‘advertisementDetails’, line 1, position 26.
- Unexpected end when deserializing object. Path ‘template’, line 1, position 50.
- Error converting value “agentId”. Path ”, line 1, position 9.
When Request Content Contains Validation ErrorsHTTP/1.1 422 Unprocessable EntityContent-Type: application/vnd.seek.advertisement-error+json;charset=utf-8; version=1
The response content will have message and errors fields. The error items may include the field field and should include the code and message fields.CodeExample Field
Example Message
AlreadySpecifiedtemplate.items[2].name
The Name field value has been used more than once in the list.
ChangeNotAllowedadvertisementType
The advertisement type cannot be changed from StandOut to Classic.
InvalidEmailAddressapplicationEmail
The ApplicationEmail field is not a valid e-mail address.
InvalidFormatjobSummary
The JobSummary field does not allow any formatting tags. Text starting with the < symbol is interpreted as a formatting tag.
InvalidRequestContent
The request must contain content of type: ‘application/vnd.seek.advertisement+json; version=1’.
InvalidState
Advertisement has already expired.
InvalidUrlapplicationFormUrl
The ApplicationFormUrl field is not a valid fully-qualified
InvalidValuethirdParties.agentId
The AgentId field is not allowed.
MaxLengthExceededstandout.bullets[1]
The field Bullets[1] must be a string or array type with a maximum length of ‘3’.
RegexPatternNotMatchedvideo.url
The field Url must match the regular expression ‘actual regular expression would be here’
Requiredtemplate.items[1].name
The Name field is required.
ValueOutOfRangesalary.maximum
The field Maximum must be between 1 and 999999. Please note: MaxSalary must be within 2 bands of Min salary (eg 65,000-69,999 is ok but 65,000 to 84,999 is not). Please see expected values tab for the Valid Values spread sheet for more details
Do not retry the request automatically.The user needs to correct the validation errors before retrying the request. When Creating an Advertisement with a CreationId that Already ExistsHTTP/1.1 409 ConflictLocation: https://{host}/advertisement/{advertisementId}
Where the location header contains the absolute URL of the existing advertisement. When Performing an Operation on an Advertisement that Does Not ExistHTTP/1.1 404 Not Found
Job Advertisement Enhancements To ensure our hirers, integration partners and mutual clients are having the best experience with SEEK’s Job Posting API, and that Job Advertisements are being uploaded successfully to SEEK the first time they are posted, the Job Posting API has been enhanced to help support the following: - Automatically removing any invalid or unsupported HTML tags – Please review the formatting tab
- Automatically removing any URL hyperlinks to display as text (only in the case where the advertiser is not allowed to use hyperlinks) – Please review the formatting tab
- Automatically removing any invalid URL link and replacing with text: [link removed] – Please review the formatting tab
- Automatically replacing the invalid maximum salary with a valid maximum salary that is within 2 bands of the minimum – Please review the Expected Values spreadsheet
- Automatically swaps the minimum salary and maximum salary when the minimum salary is greater than the maximum salary – Please review the Expected Values spreadsheet
- Automatically truncating the Job Summary character limit when exceeded and replacing the last 3 characters with an ellipsis (3 dots) – Please review the fields tab
- SEEK has updated 8 Location Descriptions to be more relevant – Please review the Expected Values spreadsheet
- If the create/update request succeeds (no validation failures), the response will contain the actual expiry date and time of the advertisement in UTC.
- SEEK will no longer be supporting the ability to add or remove a screen once the job ad has been posted. This will make shortlisting of candidates easier as this will stop different candidates being compared against different criteria for the same role.
To avoid the automatic removal, it is highly recommended that our hirers, integration partners and mutual clients only provide SEEK with valid data.