# Get a verified number

GET

`/v1/voice/verified-numbers/{verified_number_id}`

## Code Examples

TypeScript
```typescript
const verifiedNumber = await bird.voice.verifiedNumbers.get("vvn_01krdgeqcxet5s7t44vh8rt9mg");
console.log(verifiedNumber.phone_number, verifiedNumber.status, verifiedNumber.verified_at);
```

Python
```python
verified_number = client.voice.verified_numbers.get("vvn_01krdgeqcxet5s7t44vh8rt9mg")
print(verified_number.phone_number, verified_number.status, verified_number.verified_at)
```

Go
```go
verifiedNumber, err := client.Voice.VerifiedNumbers.Get(context.Background(), "vvn_01krdgeqcxet5s7t44vh8rt9mg")
if err != nil {
	log.Fatal(err)
}
fmt.Println(verifiedNumber.PhoneNumber, verifiedNumber.Status, verifiedNumber.VerifiedAt)
```

PHP
```php
$verifiedNumber = $bird->voice->verifiedNumbers->get('vvn_01krdgeqcxet5s7t44vh8rt9mg');
echo $verifiedNumber->getPhoneNumber(), ' ', $verifiedNumber->getStatus(), "\n";
```

CLI
```
bird voice verified-numbers get <verified-number-id>
```

cURL
```
curl -X GET "https://us1.platform.bird.com/v1/voice/verified-numbers/{verified_number_id}" \
  -H "Authorization: Bearer $TOKEN"
```

## Response 200

```json
{
  "id": "vvn_01krdgeqcxet5s7t44vh8rt9mg",
  "workspace_id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
  "phone_number": "+14155551234",
  "name": "Support line",
  "status": "pending",
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z"
}
```

Returns the verified number with the given ID, including its verification status.

## Parameters

`verified_number_id` `string`

ID of the verified number to retrieve, update, or delete.

## Response Payload

- `id`: string (required)
  Unique identifier for this verified number.
- `workspace_id`: string (required)
- `phone_number`: string (required)
  The phone number in E.164 format registered as an outbound caller ID.
- `name`: nullable string (required)
  Your label for this verified number, to tell several registered numbers apart. `null` when the verified number has no label.
- `status`: string (required)
  Verification state of the verified number.
  - `pending`: the number is registered but ownership has not yet been proven.
  - `verified`: the workspace proved ownership of the number.
  - `failed`: terminal because the verification challenge expired or the attempt limit was exhausted.
- `outbound_enabled`: boolean (required)
  Whether outbound caller ID activation has completed.
- `verified_at`: nullable string (required)
  When the verified number was verified. `null` when its status is `pending` or `failed`.
- `created_at`: string (required)
- `updated_at`: string (required)
