Sign inGet Started

Get a verified number

GET
/v1/voice/verified-numbers/{verified_number_id}
const verifiedNumber = await bird.voice.verifiedNumbers.get("vvn_01krdgeqcxet5s7t44vh8rt9mg");
console.log(verifiedNumber.phone_number, verifiedNumber.status, verifiedNumber.verified_at);
响应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.

参数

verified_number_idstring

响应载荷

id
string
必填

Unique identifier for this verified number.

workspace_id
string
必填
phone_number
string
必填

The phone number in E.164 format registered as an outbound caller ID.

name
nullable string
必填

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
必填

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. Delete the verified number and register it again 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
必填

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
必填

When the verified number was verified. null when its status is pending or failed.

created_at
string
必填
updated_at
string
必填