Error Codes

Spark API Error Code HTTP Status Code Description
404 404 Not found
405 405 Method not allowed
1000 401 Invalid API key and/or request signed improperly
1010 401 API key is disabled
1013 403 The auth mechanism used for this request is not permitted for the provided key
1015 403 ApiUser must be supplied, or the provided key does not have access to the supplied user
1016 400 The X-SparkApi-User-Agent request header is required. No request to the API will be successful without it. Please see the overview for additional information.
1017 405 You are restricted to read-only access. POST, PUT, and DELETE requests are forbidden.
1018 405 You are forbidden from accessing this resource with the method attempted
1020 401 Session token has expired
1025 401 The user has a Portal Group selected that is no longer valid. Set a new portal group before accessing this service.
1030 403 SSL required for this type of request
1035 400 POST data not supplied as valid JSON. Issued if the "Content-Type" header is not "application/json" and/or if the POST data is not in valid JSON format
1040 400 The _filter syntax was invalid or a specified field to search on does not exist
1041 400 (Message varies) The _filter syntax is valid but exceeds restrictions on filter or argument length
1050 400 (Message varies) A required parameter for the request was not provided
1053 400 (Message varies) A parameter was provided but does not adhere to constraints
1055 409 (Message varies) Issued when a write is requested that will conflict with existing data. For instance, adding a new contact with an e-mail that already exists
1060 400 (Message varies) A Validation field did not match existing data
1061 400 (Message varies) Attempt to reuse previous data when prohibited
1500 403 The resource is not available at the current API key's service level. For example, this error applies if a user attempts to access the IDX Links API via a non-IDX API key.
1510 503 The API is temporarily unavailable.
1515 503 Your request took too long to process and has therefore been cancelled.
1550 503 Over rate limit
2000 400 Codes 2000-2999 are reserved for value-specific errors in the _filter parameter. These are not syntax errors, but instead errors specific to the valid field present in the parameter.
2001 400 The SavedSearch specified does not exist or is not available to the current user.
2002 400 The EmailLink specified does not exist or is not available to the current user.
2003 400 The SharedListings id specified does not exist or does not contain listings.