List all numbers

This action will return a list of all numbers configured in the given unit.

Try this request in your browser

/api/ /numbers/list

Headers

X-Auth-App
X-Auth-Token
X-Auth-Secret
X-Auth-Extension
X-Auth-Password
X-Proxy-Auth-Token
X-Proxy-Auth-Secret

Parameters

unit_id Integer
page Integer
per_page Integer
sort_by String
order String
filters Hash

The request output will be shown here...

URL

https://connectapi.dial9.co.uk/api/v2/numbers/list

Access

Must be authenticated as a user or API token. If not authorised, a AccessDenied error will be returned.

Parameters

Parameter Type Default

unit_id

The ID of the unit

Integer null

page

The page number

Integer 1

per_page

The number of items to return per page

Integer 30

sort_by

The field to sort by

String number

order

The direction to order units by

String asc

filters

A hash of filters to apply to results

Hash {}

Filtering

This action supports filtering. You can filter the results which you receive by providing filters in the filters parameter. The following attributes are supported for filtering.

Attribute Supported Operators
number eq, not_eq, starts_with, ends_with, in, not_in
name eq, not_eq, starts_with, ends_with, in, not_in
context eq, not_eq, starts_with, ends_with, in, not_in

Errors

Error Attributes

UnitNotFound

The given unit was not found

  • id

    The provided ID

FilterError

An error has occurred while processing filters for this action

  • issue_code

    A more specific issue code

  • issue_message

    A more specific message about the issue

Response Data

This action will return an array of number structures.

You'll receive all attributes for this structure (basic and extended attributes). You'll receive all expansions for this stucture.