Recent pages

Edit
page

New
page

Print
page
Page last modified 17:25, 6 Jan 2012 by Admin
0
Redirect
Page Notifications Off
Documentation Wiki > Developer Documentation > XML API > Batch API Guide > Retrieve Unsubscribes (Tracking Bulk Async)

Retrieve Unsubscribes (Tracking Bulk Async)

From $1

    Table of contents
    1. 1. Method
    2. 2. Results
    Doc-Wiki-BannerHK.png

    (Click the banner to go to the related Docs.Code.ExactTarget.com page.)

    The Retrieve Unsubscribes (Tracking Bulk Async) call retrieves the subscribers in your account who unsubscribed during a specified date range. Enterprise accounts receive information from all subscribers in all applicable accounts. The ExactTarget application includes this information in a compressed .ZIP file and places that file on your FTP site or another secure FTP site.

    The input for this call requires a date range during which the unsubscribes occured. You can include a listID to retrieve status for a specific list only. The call immediately returns a batchID and places the results on the specified FTP site.

    This call returns information from current lists only; unsubscribe information cannot be retrieved from deleted subscriber lists. If a subscriber has been deleted from a list, the call returns only the email address and date information.

    Method

    To retrieve your unsubscribed subscribers, use the following syntax. This example includes the optional <listid> filter.

    <system>
    <system_name>tracking-channel</system_name>
    <action>BulkAsync</action>
    <sub_action>unsubscribe_ToFTP</sub_action>
    <search_type>daterange</search_type>
    <search_value>9/1/2010</search_value>
    <search_value2>12/31/2010</search_value2>
    <listid>9002005</listid>
</system>

    With this call, you also have the option of picking up the resulting file from your own FTP site rather than from the ExactTarget secure FTP site, by including the <results> node in your call. See the Output for a Batch File Export (Bulk Async) Call help topic for the syntax to use.

    XML Tag

    Tag Description

    <search_value>

    Start date of the reporting period, in the format M/D/ YYYY.

    <search_value2>

    End date of the reporting period, in the format M/D/ YYYY.

    <listid>

    (Optional) If you want to restrict the results to a single list, enter the list ID of the ExactTarget list.

    Results

    The immediate results of this call will be a confirmation message and the batch ID for this request, as described in Output for a Batch File Export (Bulk Async) Call. Use the batch ID to check on the status of the request; see Batch Inquire (Status Check).

    The zipped file that will be deposited to the secure FTP site (or to your own FTP site, if you used the <results> node in your call) will contain the same XML output that you receive for the Tracking Retrieve Unsubscribes method; see that topic for details.

    This page was last updated by Ryan Williams on Fri, 06 Jan 2012 21:25:41 GMT.

    If you require assistance with the ExactTarget application, please contact Global Support. If you wish to send Ryan direct feedback, fill out the form below:

     

    Was This Page Helpful?
    Suggestions or Comments:
    Name (optional):
    Email Address (optional):
    Enter 12455 backwards:
       
    Tags: (Edit tags)
    • No tags
    Attach file or image
    Files (0)
     
    Comments (0)
    You must login to post a comment.

     
    Powered by MindTouch 2010
    Admin