API error codes
API error codes are returned within the response JSON as described in the usage guide. A separate HTTP status code will also be returned within the HTTP headers for every request. Where the request was successful an HTTP status 200 will be returned. For the error conditions below, an appropriate HTTP status code will be returned.
System errors
| API error code |
HTTP status code |
Description |
Troubleshooting |
100 |
500 |
Database error, please try again later. |
Give us a shout if you continue to get this error after a few minutes. |
Authentication errors
| API error code |
HTTP status code |
Description |
Troubleshooting |
200 |
400 |
No account specified. |
Make sure you have provided the correct value for the account parameter. |
201 |
401 |
Invalid username and/or password. |
Specify a username/password. |
202 |
401 |
API not enabled for user. |
User does not have API access enabled. Click Users tab from the web interface and edit the user to enable the API. |
203 |
403 |
Because of failed login attempts, you must wait x seconds before being allowed to try logging in again. |
Ensure the username/password combination is correct. |
204 |
403 |
Account disabled. |
This user account has been disabled. Try another. |
205 |
401 |
Invalid username and/or password. |
User is invalid or does not have API access enabled. |
206 |
400 |
Invalid command. |
Check the function list to make sure you got the command syntax correct. |
207 |
400 |
Invalid command. |
Specify a command. |
208 |
403 |
This metric is only available to paid accounts. |
Upgrade your account to the paid service from the Account tab in your Server Density account. |
209 |
400 |
Invalid account. |
Check the full account URL is correct e.g. boxedice.serverdensity.com. |
210 |
403 |
Insufficient permissions to perform action. |
Check your API user has sufficient permissions to access to specified server/group. |
211 |
403 |
Action can only be performed by admin users. |
The user must be an admin user to perform this action. |
Function specific errors
Alerts
| API error code |
HTTP status code |
Description |
Troubleshooting |
300 |
400 |
No alerts found. |
Add some alerts to your account. |
301 |
400 |
No alert ID provided. |
Specify an alert ID. |
302 |
400 |
Invalid alert ID. |
Specify a correct alert ID. Use the alerts/list function to get the correct IDs. |
iPhone
| API error code |
HTTP status code |
Description |
Troubleshooting |
500 |
400 |
No deviceToken provided. |
Specify a device token. |
Metrics
| API error code |
HTTP status code |
Description |
Troubleshooting |
400 |
400 |
No server ID provided. |
Specify a server ID. |
401 |
400 |
No data available. |
Check the server ID. For time range functions, no data may be available for the specified period. |
402 |
400 |
Date range not provided. |
Specify a date range. |
403 |
400 |
Invalid date range format. Please use the ISO 8601 format without any timezone. |
The specified format was incorrect. Check the ISO 8601 format and do not include any timezone (GMT/UTC will be used). |
Servers
| API error code |
HTTP status code |
Description |
Troubleshooting |
500 |
400 |
No server ID provided. |
Specify a server ID. |
501 |
400 |
No server found with that ID. |
Specify a correct server ID. Use the servers/list function to get the correct IDs. |
502 |
400 |
No server found with that IP. |
Specify a correct server IP address. Use the servers/list function to get the correct IPs. |
503 |
400 |
Invalid IP address. |
Check the format of the IP address is correct. |
504 |
400 |
No servers found. |
Add a server to your account. |
505 |
400 |
Server limit reached. |
Upgrade your account to the paid service from the Account tab in your Server Density account. |
506 |
400 |
Server name and/or IP not provided. |
Specify both a server name and IP address. |
507 |
400 |
IP address already exists. |
A server with the specified IP already exists - choose a new IP or delete the old server. |
508 |
400 |
No group provided. |
Specify a group. |
509 |
400 |
No servers found in that group. |
Specify a correct group name that has servers within it. |
510 |
400 |
No groups found. |
Add a server to a group to create a new group. |
Users
| API error code |
HTTP status code |
Description |
Troubleshooting |
600 |
400 |
username, firstName. lastName and password are required fields. |
Make sure a value is provided for all fields. |
601 |
400 |
Username already exists. |
Choose a different username. |
602 |
400 |
No user ID provided. |
Specify a user ID. |
603 |
400 |
No user found with that ID. |
Make sure the specified ID is correct. |
604 |
400 |
You cannot delete yourself. |
Log in to the API as a different user to delete yourself. |
605 |
400 |
You cannot delete the primary admin account. |
This account cannot be deleted. |
606 |
400 |
E-mail address is invalid. |
Check the specified address is correctly formatted. |