# `bird voice caller-ids verify`

## Usage

```bash
bird voice caller-ids verify <caller-id> [flags]
```

## Description

Verify a caller ID

Complete a caller-ID verification challenge started in the dashboard. Recovery can place another verification call to the same number and requires the organization to remain eligible to register caller IDs. For expired or exhausted challenges, ask the user to delete and register the caller ID again in the dashboard. Read Voice destinations separately to confirm whether the number's country is enabled.

Build the request from flags, a JSON VoiceCallerIDVerifyRequest body via --body-file ("-" reads
stdin), or both — a flag overrides the matching body field. Run --example to
print a ready-to-edit body, or --dry-run to print the resolved request without
sending it.

## Examples

```bash
# print the body shape (no credentials needed)
bird voice caller-ids verify --example

# the body it prints:
```

```json
{
  "code": "123456"
}
```

## Options

#### Request

| Name                | Description                                                  |
| ------------------- | ------------------------------------------------------------ |
| `--body-file`       | Read the JSON request body from this file; "-" reads stdin   |
| `--example`         | Print a complete example request body, then exit             |
| `--dry-run`         | Print the resolved request without sending it, then exit     |
| `--idempotency-key` | Deduplication key; a retry with the same key won't act twice |

#### Options

| Name                | Description                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| `--code`            | The 6-digit verification code read out by the verification call. (required; or in --body-file) |
| `--response-schema` | Print the fields this command returns, then exit                                               |

## Related

| Name                                                                      | Description     |
| ------------------------------------------------------------------------- | --------------- |
| [`bird voice caller-ids get`](/docs/cli/reference/voice-caller-ids-get)   | Get a caller ID |
| [`bird voice caller-ids list`](/docs/cli/reference/voice-caller-ids-list) | List caller IDs |

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)