Error Handling

Error codes and resolutions

SmartRecruiters uses conventional HTTP response codes to indicate the success or failure of an API request. In general, code in the 2xx range indicates success, code in the 3xx range indicates additional action may need to be taken by the user agent, code in the 4xx range indicates an error, and code in the 5xx range indicates an error within the SmartRecruiters server.

HTTP Status Code Summary

CodeDescription
200 - OKEverything worked as expected
201 - CreatedThe resource was successfully created
204 - No ContentThe request was successful and there is no content to be returned
304 - Not ModifiedThe request was successful but the response has not been modified
400 - Bad RequestThe request was unacceptable, often due to missing a required parameter
401 - UnauthorizedNo valid API credential provided
403 - ForbiddenThe API credential doesn't have the access right to perform the request.
404 - Not FoundThe requested resource doesn't exist
409 - ConflictThe request conflicts with a different request
422 - Unprocessable EntityThe semantic of the request is incorrect
429 - Too Many RequestsToo many requests hit the API too quickly
500, 502, 503, 504 - Server ErrorsSomething is not right on SmartRecruiters' side