getTopDonors

Provides a list of top donors for a participant with corresponding values for the amount each has raised.

Client Servlet Server Servlet HTTP Methods Supported Requires Authentication
CRTeamraiserAPI None. GET, POST Yes.

Client API Syntax

https://secure2.convio.net/organization/site/CRTeamraiserAPI?method=getTopDonors &api_key=value &v=value [ &auth=value ] [ &center_id=value ] [ &error_redirect=value ] [ &redirect=value ] [ &response_format=xml | json ] [ &sign_redirects=value ] [ &source=value ] [ &sub_source=value ] [ &success_redirect=value ] [ &suppress_response_codes=value ] &fr_id=value [ &limit=value ] [ &auth=value ] [ &sso_auth_token=value ]

Client API Parameters

Common Client Parameters

See topic Common Parameters.

fr_id

Required. The TeamRaiser event ID.

Type xsd:nonNegativeInteger.

limit

Optional. Limit

Type xsd:string.

auth

Optional. You must provide either this parameter or the sso_auth_token parameter. If using this parameter, you must specify an auth token generated by an embedded [[S86]] session tag in a Convio web page.

sso_auth_token

Optional. You must provide either this parameter or the auth parameter. If using this parameter, you must specify a valid session authentication token returned by login, authenticateUser, or getSingleSignOnToken.

Response

See topic HTTP Status Codes.

XML response
<?xml version="1.0" encoding="UTF-8"?>
<getTopDonorsResponse 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">
  <teamraiserData>
    <name>Sample Donor 01</name>
    <total>$100.00</total>
  </teamraiserData>
  <teamraiserData>
    <name>Sample Donor 11</name>
    <total>$50.00</total>
  </teamraiserData>
  <teamraiserData>
    <name>Sample Donor 21</name>
    <total>$33.33</total>
  </teamraiserData>
  <teamraiserData>
    <name>Sample Donor 31</name>
    <total>$25.00</total>
  </teamraiserData>
  <teamraiserData>
    <name>Sample Donor 41</name>
    <total>$20.00</total>
  </teamraiserData>
  <teamraiserData>
    <name>Sample Donor 51</name>
    <total>$16.66</total>
  </teamraiserData>
  <teamraiserData>
    <name>Sample Donor 61</name>
    <total>$14.28</total>
  </teamraiserData>
  <teamraiserData>
    <name>Sample Donor 71</name>
    <total>$12.50</total>
  </teamraiserData>
  <teamraiserData>
    <name>Sample Donor 81</name>
    <total>$11.11</total>
  </teamraiserData>
  <teamraiserData>
    <name>Sample Donor 91</name>
    <total>$10.00</total>
  </teamraiserData>
</getTopDonorsResponse>

        
JSON response
{"getTopDonorsResponse":{"teamraiserData":[{"total":"$100.00","name":"Sample Donor 01"},{"total":"$50.00","name":"Sample Donor 11"},{"total":"$33.33","name":"Sample Donor 21"},{"total":"$25.00","name":"Sample Donor 31"},{"total":"$20.00","name":"Sample Donor 41"},{"total":"$16.66","name":"Sample Donor 51"},{"total":"$14.28","name":"Sample Donor 61"},{"total":"$12.50","name":"Sample Donor 71"},{"total":"$11.11","name":"Sample Donor 81"},{"total":"$10.00","name":"Sample Donor 91"}]}}

        

Comments

Submitted by GoSensGo at 08:46 PM on April 6, 2012
Optional limit is not working for this API.

Leave a Comment

Nickname
Comment
Enter this word: