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
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.nullwhen 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.nullwhen its status ispendingorfailed.created_at: string (required)updated_at: string (required)