List owned numbers

Use this method to get all the owned numbers for this account.

Please log in to see full path URL. Learn why.

get

/numbers/1/numbers

Authorizations:

Scopes:

numbers:manage

query Parameters

limit	integer <int32> Default: 50 Number of records returned per page.
number	any Searched number.
page	integer <int32> Default: 0 Page number. Use with `limit` for paging purposes.

Responses

200

401

Unauthorized

403

Forbidden

404

Not Found

429

Too Many Requests

500

Internal Server Error

Use case: Making an appointment using 2-way SMS communication

Request samples

Example

cURL

Copy

curl -L -g 'https://{baseUrl}/numbers/1/numbers' \
-H 'Authorization: {authorization}' \
-H 'Accept: application/json'

Response samples

Content type

application/json

Copy

Collapse all


{"numbers": 
[
{"numberKey": "6FED0BC540BFADD9B05ED7D89AAC22FA",
"number": "447860041117",
"country": "GB",
"countryName": "United Kingdom",
"type": "VIRTUAL_LONG_NUMBER",
"capabilities": 
["SMS"
],
"shared": false,
"price": 
{"pricePerMonth": 5,
"setupPrice": 0,
"currency": "EUR"
},
"network": "02 (Telefonica UK Ltd)",
"keywords": 
["test",
"stop"
],
"additionalSetupRequired": false,
"editPermissions": 
{"canEditNumber": true,
"canEditConfiguration": true
},
"applicationId": "default"
}
],
"numberCount": 1
}