> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loqate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Batch Processing

> Verify or parse CSV files of contact data in bulk.

Both `verify` and `parse` support batch processing via the `-b` flag, accepting CSV, TSV, and pipe-delimited files.

## Usage

```bash theme={null}
lqt verify -b contacts.csv --policy shipping -o jsonl --summary
```

## Supported file formats

* **CSV** — comma-separated (default)
* **TSV** — tab-separated
* **Pipe-delimited** — pipe (`|`) separated

## Column mapping

Reach automatically maps common column names to verification fields. Use any of the following column headers:

### Address fields

| Recognized columns                                                 |
| :----------------------------------------------------------------- |
| `address`, `address1`, `address_line_1`, `street`                  |
| `address2`, `address_line_2`                                       |
| `city`, `locality`                                                 |
| `state`, `admin_area`, `administrative_area`, `province`, `region` |
| `postcode`, `postal_code`, `zip`, `zip_code`                       |
| `country`, `country_code`                                          |

### Contact fields

| Recognized columns                   |
| :----------------------------------- |
| `email`, `email_address`             |
| `phone`, `phone_number`, `telephone` |

### Other fields

| Recognized columns                             |
| :--------------------------------------------- |
| `name`, `full_name`, `first_name`, `last_name` |
| `organization`, `company`, `org`               |

## Example CSV

```csv theme={null}
address,email,phone,country
"125 Summer St, Boston, MA 02110",user@example.com,+16175551234,US
"10 Downing Street, London, SW1A 2AA",info@gov.uk,+442071234567,GB
"1600 Pennsylvania Ave, Washington DC 20500",contact@whitehouse.gov,+12025551234,US
```

## Output formats

Use `-o` to control the output format:

| Format  | Description              | Best for                                        |
| :------ | :----------------------- | :---------------------------------------------- |
| `json`  | Single JSON array        | Small batches, debugging                        |
| `jsonl` | One JSON object per line | Streaming, large batches, piping to other tools |
| `table` | Human-readable table     | Terminal review                                 |

## Summary statistics

Add `--summary` to get aggregate statistics after the batch completes:

```bash theme={null}
lqt verify -b contacts.csv --policy standard -o jsonl --summary
```

The summary includes counts of `accept`, `review`, and `reject` outcomes, plus error counts.