# `bird voice legs get`

## Usage

```bash
bird voice legs get <leg-id> [flags]
```

## Description

Fetch one leg by ID, at any point in its lifecycle. A leg still ringing or connected carries no economics yet: `duration_ms`, `billable_ms`, `ended_at`, and `cost` are null until it ends, and the same ID then returns the settled record. Poll here to watch one known leg; use `bird voice legs list` to find legs in the first place. When a leg was refused, `rejection_reason` names the gate that turned it away.

## Procedure

Step 2 of 9 of "Watch voice legs and find out why one was refused". Previous: bird voice legs list. Next: bird voice stats summary.

## Examples

```bash
bird voice legs get <leg-id>
bird voice legs get <leg-id> -f text
# the id to pass comes from
bird voice legs list
```

## Options

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

## Related

| Name                                                          | Description |
| ------------------------------------------------------------- | ----------- |
| [`bird voice legs list`](/docs/cli/reference/voice-legs-list) | List legs   |

## Related resources

- [What is a voice API?](/explained/voice/what-is-a-voice-api) (answer)
- [Voice](/products/voice) (product)
- [Voice overview](/docs/guides/voice/overview) (docs)

[Get an implementation brief](/learn/workspace?topic=voice)