Response Codes

Every request to the Humanity API will return one of the following response codes. On a successful request (1) the data will be filled with any data relevant to your request. On any request that is not a 1, alongside the response code message we will also provide request specific information to help you in debugging/error handling (error).

-3 : Flagged API Key - Permanently Banned
-2 : Flagged API Key - Too Many invalid access attempts - contact us
-1 : Flagged API Key - Temporarily Disabled - contact us
1 : Success
2 : Invalid API key - App must be granted a valid key by Humanity
3 : Invalid token key - Please re-authenticate
4 : Invalid Method - No Method with that name exists in our API
5 : Invalid Module - No Module with that name exists in our API
6 : Invalid Action - No Action with that name exists in our API
7 : Authentication Failed - You do not have permissions to access the service
8 : Missing parameters - Your request is missing a required parameter
9 : Invalid parameters - Your request has an invalid parameter type
10 : Extra parameters - Your request has an extra/unallowed parameter type
12 : Create Failed - Your CREATE request failed
13 : Update Failed - Your UPDATE request failed
14 : Delete Failed - Your DELETE request failed
15 : Get Failed - Your GET request failed
20 : Incorrect Permissions - You don't have the proper permissions to access this
90 : Suspended API key - Access for your account has been suspended, please contact Humanity
91 : Throttle exceeded - You have exceeded the max allowed requests. Try again later.
98 : Bad API Parameters - Invalid POST request. See Manual.
99 : Service Offline - This service is temporarily offline. Try again later.