Docs

Get cost info for rented numbers

https://api.apifonica.com/v2/accounts/{accountSID}/balance/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

ParameterDescription
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.