用途：在代码中搜索、购买和管理电话号码，涉及可用号码查询、购买、监管合规与发送者分配。
主要能力：按国家代码、类型（local、national、mobile、tollFree）、包含数字等条件搜索可用号码，最多返回50条，可查看号码能力与月费；购买号码，需付费套餐，Free 套餐无法购买（返回 402 paid_plan_required），付费套餐每账号一次包含一个美国或加拿大号码（月费不高于20美元），搜索结果中 pricing.isFreeEligible 标记符合条件的号码；管理号码，包括列表、详情、重命名、绑定或解绑发送者、释放（释放前必须先解绑）；处理监管要求，carrier 按具体号码决定是否需要地址、文件或文本材料，购买前会先查询要求；还涉及美国 A2P 的 10DLC 注册（品牌、活动、号码分配），相关费用由 The Campaign Registry 按其标准从余额扣除，品牌提交一次性4美元，标准活动一次性15美元并每月10美元，LOW_VOLUME 活动一次性2美元并每月2美元，被 carrier 拒绝时一次性费用退还。
使用方式：搜索用 phoneNumbers.searchAvailable；购买用 phoneNumbers.purchase，带监管要求的购买需使用 REST 接口并传 type 与 regulatoryRequirements 字段。监管要求查询用 GET /v1/phone-numbers/requirements，地址通过 POST /v1/addresses 创建，文件需先获取一次性上传 URL、上传文件字节，再用 storageId 创建记录；号码获批前不能发消息或打电话，需轮询 regulatoryStatus，约每6小时复查一次。
限制：号码名称最长100字符；国家代码用两位 ISO 格式；创建后的地址与文件保持 pending/uploaded，不自动变为 verified 或 rejected，应关注号码的 regulatoryStatus；文档上传格式与大小由面板接受 JPEG、PNG 或 PDF 且不超过10MB，API 本身不校验；被拒绝的号码不能绑定发送者；长期处于 pending_review 需联系支持。