# Get a caller ID

`GET /v1/voice/caller-ids/{caller_id}`

Returns the caller ID with the given ID, including its verification status.

## Code samples

**TypeScript**

```ts
const callerId = await bird.voice.callerIds.get("caller-id");
console.log(callerId.phone_number, callerId.status, callerId.verified_at);
```

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

## Example response `200`

```json
{
  "id": "vci_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

- `caller_id` (string)

## Response body

- `id` (string, required): Unique identifier for this caller ID.
- `workspace_id` (string, required)
- `phone_number` (string, required): The phone number in E.164 format registered as a caller ID.
- `name` (nullable string, required): Your label for this caller ID, to tell several registered numbers apart. `null` when the caller ID 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 caller ID update operation.
- `status` (string, required)

  Verification state of the caller ID.

  - `pending`: the number is registered but ownership has not yet been proven.
  - `verified`: the workspace completed the verification call, so the number can
    be presented as the outbound caller ID.
  - `failed`: terminal because the verification challenge expired or the attempt
    limit was exhausted. Use the dashboard to remove and register the caller ID
    again to retry.

  Possible values (may grow over time): `pending`, `verified`, `failed`
- `verified_at` (nullable string, required): When the caller ID 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)