List calls

This action will provide you with a list of calls made on a given unit.

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
`filters`	Hash

The request output will be shown here...

URL

https://connectapi.dial9.co.uk/api/v2/calls/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
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
direction	eq, not_eq, starts_with, ends_with, in, not_in
connected_to_extension	eq, not_eq
initiated_at	eq, not_eq, gt, gte, lt, lte
ended_at	eq, not_eq, gt, gte, lt, lte
involves_type	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

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 a call structure.

You'll only receive basic attributes for this structure. You'll receive expansions for events.