Getting Batch Results

Get results of a batch that has completed processing by sending a GET request to the following URI. If the batch is a CSV file, the response is in CSV format. If the batch is an XML file, the response is in XML format.

Alternatively, you can monitor a Bulk API batch in Salesforce. To track the status of bulk data load jobs and their associated batches, from Setup, click Monitoring | Bulk Data Load Jobs or Jobs | Bulk Data Load Jobs. Click on the Job ID to view the job detail page.

The job detail page includes a related list of all the batches for the job. The related list provides View Request and View Response links for each batch. If the batch is a CSV file, the links return the request or response in CSV format. If the batch is an XML file, the links return the request or response in XML format. These links are available for batches created in API version 19.0 and later. The View Response link returns the same results as the following URI resource.

URI

https://instance_name—api.salesforce.com/services/async/APIversion/job/jobid/batch/batchId/result

Example request body

No request body is allowed.

Example response body

For an XML Batch:

1<?xml version="1.0" encoding="UTF-8"?>
2<results xmlns="http://www.force.com/2009/06/asyncapi/dataload">
3  <result>
4    <id>001D000000ISUr3IAH</id><success>true</success><created>true</created>
5  </result>
6  <result>
7    <id>001D000000ISUr4IAH</id><success>true</success><created>true</created>
8  </result>
9</results>

For a CSV Batch:

1"Id","Success","Created","Error"
2"003D000000Q89kQIAR","true","true",""
3"003D000000Q89kRIAR","true","true",""
4"","false","false","REQUIRED_FIELD_MISSING:Required fields are missing: [LastName]:LastName --"

The batch result indicates that the last record was not processed successfully because the LastName field was missing. The Error column includes error information. You must look at the Success field for each result row to ensure that all rows were processed successfully. For more information, see Handling Failed Records in Batches.

Note