Phone Numbers
Manage phone numbers in your Vobiz account. List owned numbers, view inventory, purchase numbers, and release numbers back to inventory.
Key Features
- List all phone numbers owned by your account with pagination support
- Browse available phone numbers in inventory
- Purchase numbers from inventory and assign to your account
- Release numbers back to inventory when no longer needed
- Master accounts (MA_) can include numbers from sub-accounts
- View detailed number information including capabilities, pricing, and status
Base URL
https://api.vobiz.ai/apiAuthentication
All Phone Number API endpoints require JWT authentication via Bearer token. The API gateway automatically adds account identification headers.
Required Headers:
- •
Authorization: Bearer {access_token}
Auto-added by Gateway:
- •
X-Auth-ID - •
X-Account-Name - •
X-Account-Type
Available Operations
The PhoneNumber Object
View the complete structure and attributes of a PhoneNumber object including number details, capabilities, billing information, and provider settings.
List Account Phone Numbers
GET request to retrieve all phone numbers owned by your account with pagination support. Master accounts can include numbers from sub-accounts.
List Inventory Numbers
GET request to browse available phone numbers in inventory (not assigned to any account) that are available for purchase.
Purchase from Inventory
POST request to purchase a number from inventory and assign it to your account. Debits balance for setup and monthly fees.
Unrent a Number
DELETE request to release a phone number back to inventory. The number will be unassigned from your account and trunk group.