Get a verified number · API reference — Bird

Get a verified number

GET

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

Code Examples

TypeScript

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

Python

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

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

$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

{
  "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