Chilkat Online Tools

Objective-C / Plivo REST API / List account phone numbers

Back to Collection Items

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>

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

CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;

http.BasicAuth = YES;
http.Login = @"{{auth_id}}";
http.Password = @"password";

CkoJsonObject *queryParams = [[CkoJsonObject alloc] init];
[queryParams UpdateInt: @"limit" value: [NSNumber numberWithInt: 5]];
[queryParams UpdateInt: @"offset" value: [NSNumber numberWithInt: 0]];

CkoHttpResponse *resp = [http QuickRequestParams: @"GET" url: @"https://api.plivo.com/v1/Account/<auth_id>/Number/" json: queryParams];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

NSLog(@"%d",[resp.StatusCode intValue]);
NSLog(@"%@",resp.BodyStr);

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": [
  ]
}