Batch Inquire (Status Check)

Method

To request an update on the status of a batch file export request, use the following syntax:

<system>
    <system_name>batch</system_name>
    <action>inquire</action>
    <search_type>batchid</search_type>
    <search_value>119792</search_value>
</system>

The <search_value> XML tag represents the batchID of the request, received when you make the initial call for the status check request.

Results

The successful completion of this script will return a status message and filename.

<?xml version="1.0"?>
    <exacttarget>
        <system>
            <Batch>
                <batchid>979804</batchid>
                <status>Complete</status>
                <filename>bulkasync_68652290_20051005141044465_1.zip</filename>
            </Batch>
        </system>
    </exacttarget>

Four possible statuses can be returned:

1. Scheduled: The request to process your export request has been received and is waiting in the queue.

2. Processing: The export is underway.

3. Complete: The export is done. See Output for a Batch File Export (Bulk Async) Call for instructions on retrieving the export file.

4. Error: An error has occurred. Contact ExactTarget Support for assistance.

If an error occurs at the time that the XML command is submitted, the error code will be returned in XML format for the appropriate error trapping routine to be implemented.