# Get a verified number

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

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

## Code samples

**TypeScript**

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

Examples: [TypeScript](/docs/api/reference/get-voice-verified-number.ts.md) · [Python](/docs/api/reference/get-voice-verified-number.py.md) · [Go](/docs/api/reference/get-voice-verified-number.go.md) · [PHP](/docs/api/reference/get-voice-verified-number.php.md) · [CLI](/docs/api/reference/get-voice-verified-number.cli.md) · [MCP](/docs/api/reference/get-voice-verified-number.mcp.md) · [cURL](/docs/api/reference/get-voice-verified-number.curl.md)

## Example 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"
}
```

## Path parameters

- `verified_number_id` (string)

## Response body

- `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. It is yours to choose and appears nowhere on a call, so changing it never affects what the person you are calling sees. Set it with the verified number update operation.
- `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. Check the
    resource's activation or direction fields for outbound availability.
  - `failed`: terminal because the verification challenge expired or the attempt limit was exhausted.
    Remove and register the verified number again in the dashboard to retry.

  Open enum: additional states may be added over time, so treat an unrecognized
  value as a future state rather than an error.

  Possible values (may grow over time): `pending`, `verified`, `failed`
- `outbound_enabled` (boolean, required): Whether outbound caller ID activation has completed. A verified number can remain inactive until activation requirements are met. Outbound calls remain subject to routing and number ownership requirements.
- `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)

## 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)