The Batch Inquire (Status Check) call requests an update on the status of a batch file export (bulk async) request. This call uses a batchID input, and it returns a status message and the name of the file found on your secure FTP site. The batch API returns the batchID when you make any batch file export call.
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>
The <search_value> XML tag represents the batchID of the request, received when you make the initial call for the status check request.</search_value>
Results
The successful completion of this script will return a status message and filename.
<exacttarget/>
<system/>
<batch/>
<batchid>979804</batchid>
<status>Complete</status>
<filename>bulkasync_68652290_20051005141044465_1.zip</filename>
Four possible statuses can be returned:
-
Scheduled: The request to process your export request has been received and is waiting in the queue.
-
Processing: The export is underway.
-
Complete: The export is done. See Output for a Batch File Export (Bulk Async) Call for instructions on retrieving the export file.
-
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.
- Tag page
- What links here
