EXPORT Affiliates API Version 4 (DEPRECATED)

Ron Torres

Modified on: Mon, 9 Nov, 2015 at 2:14 PM

EXPORT Affiliates API Version 4

Updated on 2014-03-27
Current Version: Version 4
Deprecated Version: V1, V2, V3
Requests Allowed: GET& SOAP

Summary:

Returns an array of affiliates potentially filtered by affiliate_id, affiliate_name, account_manager_id or tag_id.

Resource/WSDL Page:

http://<your_domain_here>/api/4/export.asmx?op=Affiliates

Parameters

api_key Required Type: STRING Length (Max/Min): 50	Must be a valid API key (existing and NOT expired)
affiliate_id Required Type: INT Length (Max/Min): NA	If passing anything <= 0 the result will include all affiliates. If the affiliate ID does not exist, it will return an empty array instead of an error.
affiliate_name Not Required Type: STRING Length (Max/Min): NA	Not required and can accept blank value. Used to filter records matching the value or will return all records if blank.
account_manager_id Required Type: INT Length (Max/Min): NA	Must pass at least >= 0 as value. Used to filter records matching the value or will return all records if <= 0.
tag_id Required Type: INT Length (Max/Min): NA	Must pass at least >= 0 as value. Used to filter records matching the value or will return all records if <= 0.
start_at_row Required Type: INT Length (Max/Min): NA	Must pass at least 0 as value, which means start at the beginning of the data set.
row_limit Required Type: INT Length (Max/Min): NA	Must pass at least 0 as value, which means no limit
sort_field Required Type: STRING Length (Max/Min): NA	Accepts "affiliate_id", "affiliate_name", "date_created" or 0 to ignore this filter.
sort_descending Required Type: BOOL Length (Max/Min): NA	Example Values: true, false

**Note all optional parameters still need to be passed through in the actual call. These parameters do not need a value (therefore you can use a null value).

Example Request

GET	http://demo.cakemarketing.com/api/4/export.asmx/Affiliates?api_key=dNJFmId9rI&affiliate_id=0&affiliate_name=&account_manager_id=0&tag_id=0&start_at_row=1&row_limit=1&sort_field=affiliate_id&sort_descending=FALSE

Sample XML Response:

<affiliate_export_response>
<success>true</success>
<row_count>1140</row_count>
<affiliates>
    <affiliate>
      <affiliate_id>1</affiliate_id>
      <affiliate_name>Performance + Media Network</affiliate_name>
      <tier>
        <affiliate_tier_id>1</affiliate_tier_id>
        <affiliate_tier_name>Bronze</affiliate_tier_name>
      </tier>
      <account_managers>
        <contact>
          <contact_id>2660</contact_id>
          <contact_name>Jodi Warner</contact_name>
        </contact>
      </account_managers>
      <account_status>
        <account_status_id>1</account_status_id>
        <account_status_name>Active</account_status_name>
      </account_status>
      <address>
        <street_1>1234 W. Some Street</street_1>
        <street_2/>
        <city>Los Angeles</city>
        <state/>
        <zip_code>90120</zip_code>
        <country/>
      </address>
      <website>www.cakemarketing.com</website>
      <payment_type>
        <payment_type_id xsi:nil="true"/>
        <payment_type_name/>
        <payment_type_info/>
      </payment_type>
      <contacts>
        <contact_info>
          <contact_id>1175</contact_id>
          <contact_type>
            <contact_type_id>1</contact_type_id>
            <contact_type_name>Account Manager</contact_type_name>
          </contact_type>
          <role>
            <role_id>6</role_id>
            <role_name>Affiliate</role_name>
          </role>
          <department>
            <department_id xsi:nil="true"/>
            <department_name/>
          </department>
          <first_name>John</first_name>
          <middle_name/>
          <last_name>Doe</last_name>
          <email_address>test@cakemarketing.com</email_address>
          <title/>
          <phone_work>555-1212</phone_work>
          <phone_cell>555-1212</phone_cell>
          <phone_fax/>
          <im_service/>
          <im_name/>
          <include_in_mass_emails>true</include_in_mass_emails>
          <notes/>
        </contact_info>
        <contact_info>
          <contact_id>1237</contact_id>
          <contact_type>
            <contact_type_id xsi:nil="true"/>
            <contact_type_name/>
          </contact_type>
          <role>
            <role_id>6</role_id>
            <role_name>Affiliate</role_name>
          </role>
          <department>
            <department_id xsi:nil="true"/>
            <department_name/>
          </department>
          <first_name>John</first_name>
          <middle_name/>
          <last_name>Doe</last_name>
          <email_address>test@cakemarketing.com</email_address>
          <title/>
          <phone_work>555-1212</phone_work>
          <phone_cell>555-1212</phone_cell>
          <phone_fax/>
          <im_service/>
          <im_name/>
          <include_in_mass_emails>true</include_in_mass_emails>
          <notes/>
        </contact_info>
        <contact_info>
          <contact_id>1860</contact_id>
          <contact_type>
            <contact_type_id>1</contact_type_id>
            <contact_type_name>Account Manager</contact_type_name>
          </contact_type>
          <role>
            <role_id>6</role_id>
            <role_name>Affiliate</role_name>
          </role>
          <department>
            <department_id xsi:nil="true"/>
            <department_name/>
          </department>
          <first_name>John</first_name>
          <middle_name/>
          <last_name>Doe</last_name>
          <email_address>test@cakemarketing.com</email_address>
          <title/>
          <phone_work>555-1212</phone_work>
          <phone_cell>555-1212</phone_cell>
          <phone_fax/>
          <im_service/>
          <im_name/>
          <include_in_mass_emails>true</include_in_mass_emails>
          <notes/>
        </contact_info>
        <contact_info>
          <contact_id>2165</contact_id>
          <contact_type>
            <contact_type_id>1</contact_type_id>
            <contact_type_name>Account Manager</contact_type_name>
          </contact_type>
          <role>
            <role_id>6</role_id>
            <role_name>Affiliate</role_name>
          </role>
          <department>
            <department_id xsi:nil="true"/>
            <department_name/>
          </department>
          <first_name>John</first_name>
          <middle_name/>
          <last_name>Doe</last_name>
          <email_address>test@cakemarketing.com</email_address>
          <title/>
          <phone_work>555-1212</phone_work>
          <phone_cell>555-1212</phone_cell>
          <phone_fax/>
          <im_service/>
          <im_name/>
          <include_in_mass_emails>true</include_in_mass_emails>
          <notes/>
        </contact_info>
        <contact_info>
          <contact_id>3128</contact_id>
          <contact_type>
            <contact_type_id>3</contact_type_id>
            <contact_type_name>Tech</contact_type_name>
          </contact_type>
          <role>
            <role_id>6</role_id>
            <role_name>Affiliate</role_name>
          </role>
          <department>
            <department_id xsi:nil="true"/>
            <department_name/>
          </department>
          <first_name>4</first_name>
          <middle_name/>
          <last_name>5</last_name>
          <email_address>2</email_address>
          <title/>
          <phone_work>6</phone_work>
          <phone_cell/>
          <phone_fax/>
          <im_service/>
          <im_name/>
          <include_in_mass_emails>true</include_in_mass_emails>
          <notes/>
        </contact_info>
        <contact_info>
          <contact_id>3129</contact_id>
          <contact_type>
            <contact_type_id>3</contact_type_id>
            <contact_type_name>Tech</contact_type_name>
          </contact_type>
          <role>
            <role_id>6</role_id>
            <role_name>Affiliate</role_name>
          </role>
          <department>
            <department_id xsi:nil="true"/>
            <department_name/>
          </department>
          <first_name>4</first_name>
          <middle_name/>
          <last_name>5</last_name>
          <email_address>2</email_address>
          <title/>
          <phone_work>6</phone_work>
          <phone_cell/>
          <phone_fax/>
          <im_service/>
          <im_name/>
          <include_in_mass_emails>true</include_in_mass_emails>
          <notes/>
        </contact_info>
      </contacts>
      <tags>
        <tag>
          <tag_id>2</tag_id>
          <tag_name>External</tag_name>
        </tag>
        <tag>
          <tag_id>63</tag_id>
          <tag_name>Affiliate Summit Accts</tag_name>
        </tag>
      </tags>
      <traffic_types>
        <price_formats/>
        <media_types/>
        <vertical_categories/>
        <countries/>
      </traffic_types>
      <minimum_payment_threshold xsi:nil="true"/>
      <auto_payment_fee xsi:nil="true"/>
      <pay_vat>false</pay_vat>
      <referrals_enabled>false</referrals_enabled>
      <referral_info/>
      <billing_cycle>
        <billing_cycle_id>3</billing_cycle_id>
        <billing_cycle_name>Monthly</billing_cycle_name>
      </billing_cycle>
      <currency_settings>
        <currency>
          <currency_id>1</currency_id>
          <currency_symbol>$</currency_symbol>
          <currency_name>US Dollar</currency_name>
          <currency_abbr>USD</currency_abbr>
        </currency>
        <payment_setting>
          <payment_setting_id>1</payment_setting_id>
          <payment_setting_name>Pay affiliate in system default currency</payment_setting_name>
        </payment_setting>
      </currency_settings>
      <quickbooks_id xsi:nil="true"/>
      <online_signup>false</online_signup>
      <signup_ip_address/>
      <pay_for_conversions>true</pay_for_conversions>
      <review>false</review>
      <review_new_subaffiliates>false</review_new_subaffiliates>
      <suppression>true</suppression>
      <suppression_cap xsi:nil="true"/>
      <pixel_info>
        <pixel_html>affiliate Pixel</pixel_html>
        <postback_url>http://postbackurl.com/something</postback_url>
        <postback_delay_ms>6969</postback_delay_ms>
      </pixel_info>
      <fire_global_pixel>true</fire_global_pixel>
      <blacklists/>
      <auto_approve_campaigns>false</auto_approve_campaigns>
      <auto_approve_pixels>false</auto_approve_pixels>
      <hide_offers>false</hide_offers>
      <api_key>d6lc5EmTFX8</api_key>
      <date_created>2010-09-05T17:34:15.53</date_created>
      <date_last_accepted_terms xsi:nil="true"/>
      <notes/>
    </affiliate>
</affiliates>
</affiliate_export_response>

Example Error Messages:

Error Message	Likely Cause
Invalid API key	API key does not exist or is expired