# `bird preferences get`

## Usage

```bash
bird preferences get <preference-id> [flags]
```

## Description

Read one recorded preference by ID: the channel and handle it is about, whether it grants or revokes, how much traffic it covers, and where the statement came from.

## Examples

```bash
bird preferences get <preference-id>
bird preferences get <preference-id> -f text
# the id to pass comes from
bird preferences list
```

## Options

| Name                | Description                                      |
| ------------------- | ------------------------------------------------ |
| `--response-schema` | Print the fields this command returns, then exit |

## Related

| Name                                                                | Description         |
| ------------------------------------------------------------------- | ------------------- |
| [`bird preferences create`](/docs/cli/reference/preferences-create) | Record a preference |
| [`bird preferences delete`](/docs/cli/reference/preferences-delete) | Delete a preference |
| [`bird preferences list`](/docs/cli/reference/preferences-list)     | List preferences    |