Chilkat Online Tools

phpAx / Plivo REST API / List account phone numbers

Back to Collection Items

<?php

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

$http = new COM("Chilkat_9_5_0.Http");

$http->BasicAuth = 1;
$http->Login = '{{auth_id}}';
$http->Password = 'password';

$queryParams = new COM("Chilkat_9_5_0.JsonObject");
$queryParams->UpdateInt('limit',5);
$queryParams->UpdateInt('offset',0);

// resp is a Chilkat_9_5_0.HttpResponse
$resp = $http->QuickRequestParams('GET','https://api.plivo.com/v1/Account/<auth_id>/Number/',$queryParams);
if ($http->LastMethodSuccess == 0) {
    print $http->LastErrorText . "\n";
    exit;
}

print $resp->StatusCode . "\n";
print $resp->BodyStr . "\n";


?>

Curl Command

curl -G -d "limit=5"
	-d "offset=0"
	-u '{{auth_id}}:password'
https://api.plivo.com/v1/Account/<auth_id>/Number/

Postman Collection Item JSON

{
  "name": "List account phone numbers",
  "request": {
    "method": "GET",
    "header": [
    ],
    "url": {
      "raw": "https://api.plivo.com/v1/Account/{{auth_id}}/Number/?limit=5&offset=0",
      "protocol": "https",
      "host": [
        "api",
        "plivo",
        "com"
      ],
      "path": [
        "v1",
        "Account",
        "{{auth_id}}",
        "Number",
        ""
      ],
      "query": [
        {
          "key": "type",
          "value": "local",
          "description": "The type of number. You can filter by local, mobile, fixed, national and tollfree numbers.",
          "disabled": true
        },
        {
          "key": "number_startswith",
          "value": "95",
          "description": "Only show the phone numbers that begin with this pattern.",
          "disabled": true
        },
        {
          "key": "subaccount",
          "value": "SAXXXXXXXX",
          "description": "Returns phone numbers associated to this sub account.",
          "disabled": true
        },
        {
          "key": "alias",
          "value": "testalias",
          "description": "Returns phone numbers that exactly match this alias.",
          "disabled": true
        },
        {
          "key": "services",
          "value": "voice",
          "description": "Filters phone numbers which provide the selected services",
          "disabled": true
        },
        {
          "key": "limit",
          "value": "5",
          "description": "Used to display the number of results per page. The maximum number of results that can be fetched is 20. Defaults to 20."
        },
        {
          "key": "offset",
          "value": "0",
          "description": "Denotes the number of value items by which the results should be offset. Defaults to 0"
        }
      ]
    },
    "description": "Returns a list of phone numbers that you’ve rented from Plivo or [added from your carrier](https://www.plivo.com/docs/numbers/api/account-phone-number/#docs-numbers-api-incoming-carrier).\n\n\nBelow is the list of arguments that can be passed in this API request, more information can be found [here](https://www.plivo.com/docs/numbers/api/account-phone-number#list-all-my-numbers)\n\n| Arguments   | Description | Required/Conditional/Optional     |\n| :---        |    :----:   |          ---: |\n| type      | The type of number. You can filter by local, mobile, fixed, national and tollfree numbers.| Optional  |\n| number_startswith      | Only show the phone numbers that begin with this pattern.| Optional  |\n| subaccount      | Returns phone numbers associated to this sub account.| Optional  |\n| alias      | Returns phone numbers that exactly match this alias.| Optional  |\n| services      |Filters phone numbers which provide the selected services . Possible values are:<br />voice: Indicates that phone numbers which can receive calls are to be returned.<br />sms: Indicates that phone numbers which can receive SMS are to be returned.<br />mms: Indicates that phone numbers that can receive MMS are to be returned.<br />voice,sms: Indicates that phone numbers which can receive both calls and SMS are to be returned.<br />voice,sms,mms: Indicates that phone numbers that can receive calls, SMS and MMS are to be returned.| Optional  |\n| limit      | Used to display the number of results per page. The maximum number of results that can be fetched is 20. Defaults to 20.| Optional  |\n| offset      | Denotes the number of value items by which the results should be offset. Defaults to 0. Read more about offset based pagination [here](https://www.plivo.com/docs/numbers/api/request/pagination/).| Optional  |"
  },
  "response": [
  ]
}