Get cost info for rented numbers
Overview
This request returns a list of all phone numbers you have rented along with the payment information relating to these numbers including their setup price, monthly fee, billing day.
Pagination is supported.
Request example
The following example demonstrates checking the current account balance.
curl –X GET https://api.apifonica.com/v2/accounts/{accountSID}/balance/numbers \
-u {accountSID}:{authToken}
Response example
{
"limit": 20,
"prev": null,
"next": null,
"account_sid": "{accountSID}",
"numbers": [
{
"number_sid": "{numberSID}",
"number": "48732231452",
"created": "Sun, 31 January 2016 10:15:35 +0000",
"billing_day": "Sun, 31 January 2016 10:15:35 +0000",
"monthly_price": 1.86,
"setup_price": 1.86,
"currency": "eur",
"country_name": "Poland",
"type": "mobile"
},
...
]
}
Response parameters
Parameter | Description |
---|---|
limit | A parameter describing how many records are returned at once. The default and maximum value is 20. |
prev | URI to the previous page. |
next | URI to the next page. |
account_sid | Account SID. |
numbers | List of rented numbers. |
numbers/number_sid | Unique number identifier. |
numbers/number | Number. |
numbers/created | Date and time this number was rented from Apifonica. |
numbers/billing_day | Day of the month this number is billed. |
numbers/monthly_price | Monthly fee for this number. |
numbers/setup_price | Setup price. Is taken once when the number is being rented. |
numbers/currency | Currency (default - EUR). |
numbers/country_name | Full name of the country. |
numbers/type | Type of number. One of the following values: local, mobile or sip. |