Get My Virtual Numbers

GET https://voice.8x8.com/api/v1/subaccounts/:subAccountId/numbers

The Number Health Service provides insights about the reachability/availability for the numbers assigned to your subaccount.

Request

Path Parameters

    subAccountId stringrequired

    Possible values: >= 3 characters and <= 50 characters, Value must match regular expression ^[A-Za-z0-9\-._&]{3,50}$

    You must replace {subAccountId} with the subaccountid that you want to use. By default this is generated once you have completed the voice onboarding.

Should the request be authenticated successfully and Virtual Numbers are assigned to your subaccount, the response will contain a list of Number objects with health details for the numbers.

The following is an example of successful response:

Schema

    totalNumbersinteger

    The total number of assigned Virtual Numbers to your subaccount.

    lastUpdatedAtstring

    Date and Time of the last time a status update was made to any of the assigned Virtual Numbers

    numbers object[]

  • Array [
  • msisdnstring

    Virtual Number in E.164 format

    dateCreatedstring

    Date and Time the Virtual number has been assigned to the subaccount

    dateUpdatedstring

    Date and Time when any information for the Virtual Number has been changed

    countryCodestring

    Two-letter country code of the Virtual Number

    operationalStatusstring

    Number status:

    • Active
    • Expiring
    • Inactive
    referenceIdstring

    Unique identifier for the number range the Virtual number belongs to

    rentalPricenumber

    Reccuring monthly fee for the Virtual Number

    incomingRatenumber

    Minute based inbound fee for calls made to the Virtual Number

    billingUnitinteger

    Billing increment for inbound call duration . Applied to all inbound calls to the Virtual Number

    uristring

    Individual Virtual Number URI, to get the Number Health information for a single Virtual Number

    numberHealthCheckEnabledboolean

    Boolean check if Number Health services are enabled for this Virtual Number

    billingCurrencystring
    numberTypestring

    numberHealth object

    isHealthyboolean

    Last Virtual Number Health status

    statusstring
    lastCheckedTimestring

    Date and Time of the last time a status update was made to this Virtual Number

  • ]
  • statusCodeinteger
    statusMessagestring
{
"totalNumbers":0,
"lastUpdatedAt":"string",
"numbers":[
{
"msisdn":"string",
"dateCreated":"string",
"dateUpdated":"string",
"countryCode":"string",
"operationalStatus":"string",
"referenceId":"string",
"rentalPrice":0,
"incomingRate":0,
"billingUnit":0,
"uri":"string",
"numberHealthCheckEnabled":true,
"billingCurrency":"string",
"numberType":"string",
"numberHealth":{
"isHealthy":true,
"status":"string",
"lastCheckedTime":"string"
}
}
],
"statusCode":0,
"statusMessage":"string"
}

Source: https://developer.8x8.com/connect/reference/get-virtual-numbers · 8x8 CPaaS Developer Docs. Synced for support deflection.

Was this article helpful?
or
0 out of 0 found this helpful

0 Comments

Please sign in to leave a comment.

Didn't find what you were looking for?

Submit a request