Numbers
List number purchases
Returns the numbers you have bought through Vobiz, newest first, each with its full list of wallet charges. Released numbers stay in the list with status: released, so this is the billing history of every number you have owned.
GET
/
numbers
/
purchases
cURL
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/numbers/purchases \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.numbers.list_purchases()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/numbers/purchases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"purchases": [
{
"id": "5c2d9e7a-1b4f-4a8c-9e3d-6f7a0b1c2d3e",
"accountId": "MA_XXXXXXXX",
"provider": "internal",
"e164": "+14155550100",
"countryCode": "US",
"type": "VIRTUAL_LONG_NUMBER",
"capabilities": [
"VOICE",
"SMS",
"MMS"
],
"setupAmount": 1,
"monthlyAmount": 1,
"currency": "USD",
"status": "purchased",
"purchasedAt": "2026-10-12T09:06:44Z",
"nextBillingAt": "2026-11-12T09:06:44Z",
"releasedAt": null,
"createdAt": "2026-10-12T09:06:42Z",
"updatedAt": "2026-10-12T09:06:44Z",
"charges": [
{
"purchaseId": "5c2d9e7a-1b4f-4a8c-9e3d-6f7a0b1c2d3e",
"kind": "purchase",
"periodStart": "2026-10-12T09:06:42Z",
"amount": 2,
"currency": "USD",
"status": "paid",
"reference": "sms_number_purchase:5c2d9e7a-1b4f-4a8c-9e3d-6f7a0b1c2d3e",
"attempts": 1,
"attemptedAt": "2026-10-12T09:06:42Z"
}
]
}
]
}{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}{
"error": "number purchasing is not available"
}Authorizations
Your Vobiz account Auth ID (MA_XXXXXXXX).
Your Vobiz account Auth Token.
Response
Your purchases.
The numbers you have bought, with their billing history.
Your purchases, newest first, including released numbers. Empty array when you have never bought a number.
Show child attributes
Show child attributes
Was this page helpful?
⌘I
cURL
curl --request GET \
--url https://api.vobiz.ai/api/v1/sms/numbers/purchases \
--header 'X-Auth-ID: <api-key>' \
--header 'X-Auth-Token: <api-key>'from vobiz import Vobiz
client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN")
client.sms.numbers.list_purchases()
const options = {
method: 'GET',
headers: {'X-Auth-ID': '<api-key>', 'X-Auth-Token': '<api-key>'}
};
fetch('https://api.vobiz.ai/api/v1/sms/numbers/purchases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"purchases": [
{
"id": "5c2d9e7a-1b4f-4a8c-9e3d-6f7a0b1c2d3e",
"accountId": "MA_XXXXXXXX",
"provider": "internal",
"e164": "+14155550100",
"countryCode": "US",
"type": "VIRTUAL_LONG_NUMBER",
"capabilities": [
"VOICE",
"SMS",
"MMS"
],
"setupAmount": 1,
"monthlyAmount": 1,
"currency": "USD",
"status": "purchased",
"purchasedAt": "2026-10-12T09:06:44Z",
"nextBillingAt": "2026-11-12T09:06:44Z",
"releasedAt": null,
"createdAt": "2026-10-12T09:06:42Z",
"updatedAt": "2026-10-12T09:06:44Z",
"charges": [
{
"purchaseId": "5c2d9e7a-1b4f-4a8c-9e3d-6f7a0b1c2d3e",
"kind": "purchase",
"periodStart": "2026-10-12T09:06:42Z",
"amount": 2,
"currency": "USD",
"status": "paid",
"reference": "sms_number_purchase:5c2d9e7a-1b4f-4a8c-9e3d-6f7a0b1c2d3e",
"attempts": 1,
"attemptedAt": "2026-10-12T09:06:42Z"
}
]
}
]
}{
"error": "missing or invalid credentials"
}{
"error": "internal error"
}{
"error": "number purchasing is not available"
}