API Error Codes
Your application should check for error code responses from our API - do not assume that a query was successful. Error codes could be produced by using incorrect username and password details, leaving out required extra parameters, providing incorrectly formatted values or an internal API error.
Below we have provided a list of all possible error codes, what they mean and their solutions.
Note: The error message can vary between API functions, while error codes stay consistent.
2XX - Internal Error
Meaning: Indicates an internal error. This could be caused by our servers being overloaded or scheduled maintenance.
Solution: Try again in a few minutes. If you continue to receive this error, please contact us.
3XX - Authentication Error
Meaning: You have not included your username and/or password or the username and password provided are incorrect.
Solution: Make sure you have included your username and password in the query and that the values are correctly URL encoded (particularly if your username is an e-mail address).
Meaning: Username and password provided are correct, but the API key provided was invalid.
Solution: Make sure you are including your API key in your query. If you do not have an API key, contact us to obtain one.
4XX - Invalid Input
Meaning: You have not included a valid mode value. Valid modes are: add_domains, delete_domains, list_domains, add_folder, delete_folder, edit_folder, list_folders, fetch, report, domainreport, reportlist, list_parking_providers, add_account, delete_account, edit_account and list_accounts.
Solution: If you have included the mode attribute, check the spelling of the value. You may have added an 's' to the end or something may be incorrectly spelt.
41X - Missing Parameter
Meaning: The domains parameter is missing or the domain or domains you have specified are invalid.
Solution: Make sure domains are comma separated, for example: "domain1.com,domain2.com,domain3.com". Also check the spelling of "domains".
Error Code 411 - Report ID is Missing or Invalid / Job id is a required argument / Job was not found
Meaning: You have not included the reportid or jobid parameter or the report /job id cannot be found, which is required for the selected mode.
Solution: Include the reportid or parameter jobid in your query. If you have included it, check the spelling of "reportid" or "jobid" and check the value is a valid reportid / jobid.
Meaning: You are using the incorrect combination of period, from_date and to_date.
Solution: You can include either a period or from_date and to_date in a report query. Dates must be in the format YYYY-MM-DD. Accepted values for period are "today", "yesterday", or a specified number of days or months such as "7 days" or "3 months".
Error Code 413 - Folder Not Found / No folder id parameter passed / The (Trash) and (Default) folders may not be deleted or edited / Improper JSON string provided for services
Meaning: The specified folder does not exists, you have not specified a folder or you are trying to delete the (Trash) or (Default) folders.
Solution: Make sure the folder exists in your account and that you have correctly URL encoded the value of folder.
Meaning: The specified service does not exists or the parking service ID specified does not exist (park_id=1234).
Solution: Make sure the service exists in your account and that you have correctly URL encoded the value of service or the parking service ID specified exists (park_id. A list of parking services and their IDs can be retrieved using the List Parking Providers API function.
Meaning: The groupby value was invalid.
Solution: Check your groupby value is valid. Accepted values are "domain", "day", "month" or "folder".
Meaning: The account_id value was invalid or the specified account ID does not exist in your account.
Solution: Check your account_id value is valid and that the specified account ID exists in your account. A list of parking service accounts and their IDs can be retrieved using the List Accounts API function.
Meaning: The force_disable value was not provided.
Solution:Set a force_disable value along with the disable request to disable the account. This extra step is to ensure that users do not disbale an account with domains resulting in such domains becoming unservable.
Meaning: You have changed a folder to use a custom page (custom=1), but you have not specified a value for redirect.
Solution: Make sure you have included a value for redirect and that it is a valid URL.
Meaning: You are adding a new parking service account, but have not specified acc_username and/or acc_password.
Solution: Make sure to include values for both acc_username and acc_password and that values are correctly URL encoded.
Meaning: You have added an API key (sdo_signkey) for the SEDO service and have not specified the currency (currency).
Solution: Make sure that you specify EURO or USD currency (currency=EURO or currency=USD) when adding a SEDO API key (sdo_signkey).
Meaning: You have not entered an API key which is required for ParkingCrew (pkc_api_key) and DomainApps (dap_apikey) accounts.
Solution: Make sure to include the API Key for the parking service and that values are correctly URL encoded.
Error Code 426 - GUID must be 36 characters long / API key may only contain letter and numbers, and must be 32 characters in length / API key may only contain letters and numbers / API key may only contain letters from A to F, and numbers, and must be 32 characters in length
Meaning: The API key you have entered is too short/long or has special characters or has letters from G to Z which are not accepted.
Solution: Make sure the API key has been entered correctly and that values are correctly URL encoded.
Meaning: The SEDO partner ID (sdo_partnerid) you have entered contains letters or special characters which are not accepted.
Solution: Make sure the SEDO partner ID (sdo_partnerid) only contains numbers and that values are correctly URL encoded.
Meaning: A redirect percentage for value has not been entered or is not numeric or has a decimal.
Solution: Make sure the percentage values for park_id, blank=1 and for_sale redirect settings do not have decimals, are numeric and are correctly URL encoded.
Meaning: An account for the parking service (park_id) does not exist in your account.
Solution: Make sure the ID number for the park_id is correct and that values are correctly URL encoded.
Meaning: The total percentage of redirect settings (park_id, blank=1 and for_sale) does not equal 100.
Solution: Make sure values for park_id, blank=1 and for_sale total 100 and that values are correctly URL encoded.
Meaning: You have entered an incorrect format for the parameter.
Solution: Make sure that you use either (&format=csv) or (&format=xml) for the format.
Error Code 500 - Requested report could not be generated / Account addition failed: NOTICE: (reason) / Job failed. Please contact support if problems persist
Meaning: The requested report or job could not be generated or the parking service account could not be added.
Solution: Try again. If requesting the report or job again fails, please contact support. If you are adding an account, make sure an account with that username does not already exist or take note on the reason returned.