# Retrieve the Batch Status
source: https://developer.mastercard.com/mastercard-gateway/documentation/integrations-types/hosted-batch/integrate-hosted-batch/retrieve-batch-status/index.md

Once a batch is submitted you can periodically request a batch status to determine the current state of the batch processing including a count of the total uploaded, processed, and erred operations as well as time and date stamps on processing actions. The same batch status is also visible to your payment service provider through the Batch Status Search screen in Merchant Manager.

## Batch status request {#batch-status-request}

You can request a batch status on demand by sending an HTTPS GET request to:

`{{host}}/batch/version/<versionNum>/merchant/<merchantId>/batch/<batchName>/status`

Where:

* `<versionNum>` is the version of Batch
* `<merchantId>` is your Merchant identifier
* `<batchName>` is your unique name for the batch

## Batch status response {#batch-status-response}

The response body contains a summary of processing in CSV format with one header row and a detail row.

A sample batch status summary file in CSV format showing batch status as "COMPLETE".

```csv
"merchantId","batchName","totalRecords","uploadCompleted","batchStatus","processed","errors","lastAction","processingCompleted"
"TESTMERCHANT","testfile20110818a","46","2011-08-18T10:40:20+10:00","COMPLETE","46","0","2011-09-11T02:36:10+10:00","2011-08-18T10:40:30+10:00"
```

The table describes the information returned in the batch response file.

### Batch Status Field Descriptions {#batch-status-field-descriptions}

|         Field         |                                                                                                                                                                   Description                                                                                                                                                                   |
|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `merchantId`          | The merchant's unique alphanumeric identifier. There is a unique Merchant ID for each merchant account/profile.                                                                                                                                                                                                                                 |
| `batchName`           | The batch file name used during initial upload.                                                                                                                                                                                                                                                                                                 |
| `totalRecords`        | The total number of operations in the batch.                                                                                                                                                                                                                                                                                                    |
| `uploadCompleted`     | The time and date uploading of all records was completed.                                                                                                                                                                                                                                                                                       |
| `batchStatus`         | The current batch processing status. Valid values are: * **Uploading** --- the batch is in the process of being uploaded. * **Uploaded** --- the batch is successfully uploaded. * **Ready** --- the batch is ready for processing. * **Processing** --- the batch processing has started. * **Complete** --- the batch processing is complete. |
| `processed`           | The total count of records processed.                                                                                                                                                                                                                                                                                                           |
| `errors`              | The total count of records which have timed out or could not be processed due to system errors.                                                                                                                                                                                                                                                 |
| `lastAction`          | Time and date of the last action on the batch.                                                                                                                                                                                                                                                                                                  |
| `processingCompleted` | The time and date when the batch processing completes and all records are in their final state.                                                                                                                                                                                                                                                 |

The next step is [processing the batch response](https://developer.mastercard.com/mastercard-gateway/documentation/integrations-types/hosted-batch/integrate-hosted-batch/process-the-batch-response/index.md).