Status and Error Codes

The following Status codes and Error codes apply when using the Convio client APIs for Constituent Management.

 

Status Codes

Code	Description
200	OK. Indicates a successful invocation.
302	Redirect. The invocation may have been successful or an error may have occurred. The redirect parameter was specified in the request so the response is a redirection to that URL.
403	Forbidden. Indicates that the request was received and understood but an error occurred. Parse the content text for more information.
405	Bad Method. Indicates that the request was not sent using the "post" HTTP method.

 

Generic Error Codes

Code	Description
1	Generic error.
2	Missing or incorrect API key.
3	Authentication or authorization failed. Either the system does not recognize the authentication credentials provided or the authenticated user does not have permission to access information as requested.
4	The request was made from an IP address that is not allowed to call the requested method.
5	The requested method can only be called from a trusted source.  If this is being called from a page served by Convio, check that the Convio Authentication Token component is included in the form.  If you are using AJAX to call the API, check that the name and value of the authentication token are included in the API call.
6	No method was specified in the request.
10	Required fields missing. One or more fields required for the requested method are missing. Note that the error does not return which specific fields are missing.
405	Bad HTTP method. Requests must be made via the "post" HTTP method.

 

Constituent API Error Codes

Code	Description
11	Cannot add the new user because there is already a matching record.
12	Cannot add or update the user because there is already a record having the same user name.
13	Cannot add or update the user because there is already a record having the same email address and the site is configured to disallow duplicate email addresses.
14	The requested method is not allowed by the caller.
15	Cannot update the user because multiple records match the search criteria.
16	Cannot access the user because no records match the search criteria.
17	No method was requested or the requested method does not exist.
18	The requested field was not found.
19	The members of a group could not be retrieved.

 

Donation API Error Codes

Code	Description
101	The donation failed.
102	No donation form was specified or the form is inaccessible (doesn't exist or is not published or caller doesn't have permission).
103	No donation level was specified or the level is inaccessible (doesn't exist or is not published).