Error Codes & Responses

HTTP Status Codes

The iarya API attempts to return appropriate HTTP status codes for every request.
Code Text Description
200 OK Successful Call.
304 Not Modified No new data to return.
400 Bad Request Request invalid or cannot be otherwise services. An accompanying error message will explain further. Requests without authentication are considered invalid and will yield this response.
401 Unauthorized Missing or incorrect authentication credentials.
403 Forbidden Request is understood but access is not permitted.
404 Not Found URL requested is invalid or the resource requested, including user does not exist. The error also returned when the requested format is not supported by the requested method.
406 Not Acceptable Returned by the Search API when the request includes an invalid format.
410 Gone This resource is no longer available. Used to indicate that an API endpoint has been turned off.
500 Internal Server Error Processing error. Please email additional details of the request to support@leoforce.com in order for the Arya Client Support team to investigate.
502 Bad Gateway Arya service is currently not available or being upgraded at this time.
503 Service Unavailable Arya servers are available but overloaded with requests at this time. Please try again later.
504 Gateway timeout Arya Servers are available but the request could not be serviced due to a failure within our services stack. Please try again later.

Error Messages

When the iarya API returns error messages, it does so in XML/JSON format.

Error Codes

In addition to descriptive error text, error messages contain machine-parseable codes. While the text for an error message may change, the codes will stay the same. The following table describes the codes which may appear when working with the API:
Code Text Description
101 Job object is null. JSON is missing for the Job.
102 Invalid Organization or API KEY. Organization ID is invalid.
103 Client JobID is null. Client Jobid is required.
104 Client OrgID is null. Client Orgid is required.
105 Job title is null. Job title is required.
106 Description is Null. Job Description is required.
105 Job title is null. Job title is required.
109 User is not configured in Arya. User not setup in Arya.
110 Invalid JSON. Invalid JSON format.
111 Experience format is not correct. Experience format invalid.
112 Not found. Requested information not found.
116 Min experience should be less then max experience. Minimum must be less than Maximum.
117 Job not found. Requested Job not found.
118 Country not found. Requested Country not found.
119 Monster cat is not configred or cat is inactive for this user. Monster CAT [Company Access Token] not configured or inactive for user.
120 The candidate details doesn't exists. Candidate details do not exist.
121 Recruiter_Email is mandotary. Recruiter email address is required.
125 Request has been submitted. Request has been submitted.
126 This user doesn't have mailing permission. This user doesn't have mailing permission.
127 TemplateId required. TemplateId required.
128 No Candidate has contact to send email. No Candidate has contact to send email.
200 Job Updated Successfully/Job Created Successfully. Job created or updated successfully.
201 Job updated successfully. Job updated successfully.
202 Job created successfully. Job created successfully.
203 Arya activated successfully. Arya activated successfully.
204 Arya deactivated successfully. Arya deactivated successfully.
205 Shortlisted successfully. Candidate(s) shortlisted successfully.
206 Ignored successfully. Candidate(s) ignored successfully.
221 Search criteria updated successfully. Search Criteria updated successfully.
222 Search criteria saved successfully. Search Criteria saved successfully.
223 Client created successfully. Client created successfully.
224 Client Updated successfully. Client updated successfully.
225 Client name already exist. Client name already exists.
226 ATS Client ID already exist.
227 ATS Client ID already exist. ATS Client ID already exist.
228 Only organization admin is allowed to make this call. Call restricted to client Administrator.
229 Client Competitor Company updated successfully. Client Competitor Company updated successfully.
230 Client Industry updated successfully. Client Industry updated successfully.
231 User criteria added successfully. User criteria added successfully.
331 Invalid Email Address. Invalid Email Address.
332 Client name is null. Client name is null.
500 An error has occurred. An error has occurred. Please forward details of API call to support@leoforce.com.
505 User created successfully. Successfully user creation is done in arya.
565 Job refrence ID updated successfully. Job Reference ID updated successfully.
566 Job Email Configuration updated successfully. Job Email Configuration updated successfully.
567 PortalCode not valid. PortalCode not valid.
568 EmailConfig object is null. EmailConfig object is null.
569 Max Email should be greater then zero. Max Email should be greater then zero.
570 Single Time should be greater then zero. Single Time should be greater then zero.
571 Applied Count should be greater then zero. Applied Count should be greater then zero.
572 Max email should be greater then singletime. Max email should be greater then singletime.
573 Removed from the Shortlisted. Removed from the Shortlisted.
574 Removed from the Ignored. Removed from the Ignored.
575 Work Status not found. Work Status not found.
576 Pending. Gold Set candidate assignment pending.
577 Processed. Gold Set candidate assignment processed.
578 Invalid Url. Gold Set candidate url is invalid.
579 This feature is only for social using this API call. This feature is only for social using this API call.
580 Invalid Zipcode. Invalid Zipcode.
581 Please provide Country ID. Please provide Country ID.
582 The contact information provider you selected did not find contact info for this candidate. Please select another provider name to receive your credit. The contact information provider you selected did not find contact info for this candidate. Please select another provider name to receive your credit.
583 Contact credited back successfully. Contact credited back successfully.
584 Careerbuilder login detail is invalid. Careerbuilder login detail is invalid.
585 The user is not configured with careerbuilder. The user is not configured with careerbuilder.
586 No Candidates found for this search query. No Candidates found for this search query.
587 Download limit reached please contact to support or org admin. Download limit reached please contact to support or org admin.
588 ResumeID not found in input parameter. ResumeID not found in input parameter.
589 Organization does not have permission for this call. Organization does not have permission for this call.
590 User already exist. User already exist in Arya.
591 Role name is invalid. Role is invalid.
592 Email value is required. Email is required.
593 Firstname value is required. First Name is required.
594 Lastname value is required. Last Name is required.
595 Login Name value is required. Login Name/User Name is required.
596 Login Name and email should be same. Login Name/User Name and Email should be same.
597 ToDate must be equal or less than today's date ToDate must be equal or less than today's date
598 Invalid jobboard name Invalid jobboard name
599 Invalid From Date or To Date. Invalid From Date or To Date.
600 User profile updated successfully. User profile updated successfully.
601 User doesn't exist in Arya. User doesn't exist in Arya.
602 Userid is required. Userid is required.
603 From date must be equal to or less than today's date. From date must be equal to or less than today's date.
604 Invalid Work Phone. Invalid Work Phone.
605 Invalid Home Phone. Invalid Home Phone.
606 Candidate posted successfully. Candidate posted successfully.
607 Aryatype not found. Aryatype not found.
608 Candidate already pushed. Candidate already pushed.
609 Intel not generated. Intel not generated.
610 Invalid SourceTypeId. Invalid SourceTypeId.
612 Invalid CompetitorCompany ID. Invalid CompetitorCompany ID.
613 Invalid ClientIndustry ID. Invalid ClientIndustry ID.
614 Company Name Value is required. Company Name Value is required.
615 Industry Value is required. Industry Value is required.
616 User criteria not found for given job ID. User criteria not found for given job ID.
617 Feeder value can not be greater than 2 as well as less than 0. Feeder value can not be greater than 2 as well as less than 0.
618 ToDate must be equal or greater than FromDate. ToDate must be equal or greater than FromDate.
619 Candidate is not associated with the provided job. Candidate is not associated with the provided job.
620 Multiple jobs found with the same JobID, please pass client information to resolve the conflict. Multiple jobs found with the same JobID, please pass client information to resolve the conflict.
621 Job title cannot be null/empty string. Job title cannot be null/empty string.
623 Country not supported! Country not supported!
624 State not supported! State not supported!
625 Invalid zip code! Invalid zip code!
626 Missing zip code! Missing zip code!
628 State is mandatory when City is provided. State is mandatory when City is provided.
629 Email Template details are mandatory. Email Template details are mandatory.
630 Criteria has not been generated. Criteria has not been generated.
631 Goldset candidate doesn't exist. Goldset candidate doesn't exist.
632 Goldset candidate deleted successfully. Goldset candidate deleted successfully.
633 jobid cannot be empty or zero jobid cannot be empty or zero
634 Job is not US based job Job is not US based job
635 Job not found! Job not found!
636 This feature is not yet enabled for you. This feature is not yet enabled for you.
637 The user is given jobid, not in given Organization. The user is given jobid, not in given Organization.
640 Candidate opted out of Arya. Candidate opted out of Arya.
641 AtsType type must be loop or searcher only. AtsType type must be loop or searcher only.
642 Successfully saved attachment for job. Successfully saved attachment for job.
643 Intel not generated for job. Intel not generated for job.
699 You don't have enough credit to perform this action. You don't have enough credit to perform this action.
700 Failed to send sms for the candidate. Failed to send sms for the candidate.
701 Failed to get SIP Configuration. Failed to get SIP Configuration.
702 Invalid values in aryaType and uniqueid and countrycode. Invalid values in aryaType and uniqueid and countrycode.
703 Candidate Shortlisted Successfully. Candidate Shortlisted Successfully.
704 This Candidate is already been Shortlisted. This Candidate is already been Shortlisted.
705 Candidate Unshortlisted Successfully. Candidate Unshortlisted Successfully.
706 This Candidate is already been Unshortlisted. This Candidate is already been Unshortlisted.
707 Invalid Values in AggregateOn. Supporting AggregateOn Values is Title, CurrentCompany, Location, sources. Invalid Values in AggregateOn. Supporting AggregateOn Values is Title, CurrentCompany, Location, sources.
708 Push to ATS failed for this Goldset candidate. Push to ATS failed for this Goldset candidate.
709 This Candidate is already been Ignored. This Candidate is already been Ignored.
710 This Candidate is already been UnIgnored. This Candidate is already been UnIgnored.
711 Unable to download the candidate. Unable to download the candidate.
712 Candidate ID is mandatory for shortlisted. Candidate ID is mandatory for shortlisted.

If you receive an error response currently not listed in this table, please refer to the HTTP status code in order to determine the best method to address the error.