listUserFieldChoices

For fields returned by the listUserFields method with a "valueType" of "ENUMERATION" and some of the "TEXT" fields, the possible values are constrained to a pre-defined list.  Use this method to get the list of possible values for a given field when calling from a Web Client.

Post URL

Deconstructing the URL
* In most cases secure2.convio.net matches a client's secure domain.  However, in some cases this will be different.  If your organization uses Convio for fundraising, the correct secure domain for the API is identical to the secure domain for your fundraising forms.  So if the sample above does not work, look for the unique secure domain used for your organization and replace the secure2.convio.net portion above with this URL.

*Here, organization is a client's unique identifier in the Convio system.  Every client has a unique value that represents their instance of the product. If you're organization uses a custom secure URL for donations, the organization portion of the URL may not be necessary, contact support for assistance.

Example: https://demo-secure.convio.net/demo829/site/CRConsAPI.  Here you'll notice that demo-secure.convio.net is used for the domain, and demo829 is used for the organization. 

Authentication

This method does not require authentication of the caller.

Parameters

The parameters for this method include the following:

Name

Description

api_key Required. An arbitrary value that must be passed when invoking the Convio Client and Server APIs. The value passed by the caller must match the value in the CONVIO_API_KEY site configuration parameter, which is unique for each Convio site.
v Required. API version to invoke. Must be "1.0".

method

Required. Specifies which method to perform. To invoke this API use the value "listUserFieldChoices"

response_format

Optional. Specifies the format in which to return the response. Can be either "xml" (the default value) or "json".

redirect

Optional. Specifies a URL redirect to send back to the browser after processing.

field

Required. Specifies the name of the constituent field for which to return the possible values.

 

Response

The HTTP status code of 200 indicates a successful invocation. The response is formatted as XML by default, but the response_format input parameter can be used to specify either XML or JSON formatting. A successful invocation might appear as follows:

XML format: 
<listConsFieldChoicesResponse 
  xsi:schemaLocation=http://convio.com/crm/v1.0
  http://service.convio.net/xmlschema/crm.public.v1.xsd
  xmlns="http://convio.com/crm/v1.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">


<choice>Mr.</choice>
<choice>Ms.</choice>
<choice>Mrs.</choice>
<choice>Dr.</choice>


</listConsFieldChoicesResponse>

 

JSON format: 
{"listConsFieldChoicesResponse":{"choice":["Mr.","Ms.","Mrs.","Dr."]}}

 

Errors

After an error occurs during processing, the structure of the response is an "errorResponse" element. It contains two other elements: a "code" element and a "message" element. The "code" element contains a number corresponding to the error conditions documented on the error code list page. The "message" element contains a text message that may provide further detail about the error.

XML format: 

<errorResponse
  xsi:schemaLocation=http://convio.com/crm/v1.0
  http://service.convio.net/xmlschema/crm.public.v1.xsd
  xmlns="http://convio.com/crm/v1.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">


<code>18</code>
<message>The specified field does not exist.</message>


</errorResponse>

 

JSON format: 
{"errorResponse":{"code":"18",
"message":"The specified field does not exist."}}

 

See the complete list of HTTP Status codes and Error codes for calling from a Web Client.

 

Client Community
Log in to chat with other clients and partners using APIs and share code snippets.

Community