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

# match

> Match records in a dataset against Landbase's database

Match records in an uploaded dataset against Landbase's company and contact database. Returns a new dataset with match results appended.

## match

**Usage**

```bash theme={null}
landbase-cli match <dataset-id> [flags]
```

<ParamField path="dataset-id" type="string" required>
  The ID of the dataset to match. Obtain a dataset ID by running `landbase-cli upload` or `landbase-cli datasets list`.
</ParamField>

**Flags**

| Flag                  | Default | Description                                      |
| --------------------- | ------- | ------------------------------------------------ |
| `--wait`              | —       | Block until the match completes before returning |
| `--timeout=<seconds>` | \~600   | Override the default polling timeout             |
| `--no-update-check`   | —       | Skip the daily update check                      |
| `--verbose`           | —       | Print request/response details to stderr         |

**Examples**

```bash theme={null}
# Match a dataset and wait for results
landbase-cli match <dataset-id> --wait

# Match with a custom timeout
landbase-cli match <dataset-id> --wait --timeout=300
```