> ## 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]
```

**dataset-id** `string` *required*

The ID of the dataset to match. Obtain a dataset ID by running `landbase-cli upload` or `landbase-cli datasets list`.

**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
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.