Skip to main content
Retrieve a list of telephony log events. There is a two minute delay in availability of new telephony logs in the response. Querying for logs more recent than two minutes will retrieve an empty response. Duo recommends requesting logs no more than once per minute. Note: This action requires the Grant read log API permission.
External DocumentationTo learn more, visit the Duo documentation.

​
Basic Parameters

ParameterDescription
Maximum TimeRetrieve logs that have a timestamp of Maximum Time or earlier.

This value must be strictly greater then Minimum Time.
Minimum TimeRetrieve logs that have a timestamp of Minimum Time or later.

This value must be strictly less then Maximum Time.

​
Advanced Parameters

ParameterDescription
LimitThe maximum number of records to retrieve. Defaults to 100, with maximum value of 1000.
Next OffsetThe offset at which to start record retrieval.

The offset is provided in the metadata field of a previous List Telephony Logs response in the form of a 13 character date string in milliseconds and the event txid.

These two values must be provided together, separated by a comma (e.g. 1547486297000,5bea1c1e-612c-4f1d-b310-75fd31385b15).

When used with Limit, the handler will return Limit records starting at the n-th record, where n is the offset.
SortThe order in which to return the logs.

​
Example Output

{
	"stat": "OK",
	"response": [
		{
			"context": "authentication",
			"credits": 1,
			"isotimestamp": "2020-03-20T15:38:12+00:00",
			"phone": "+15035550100",
			"timestamp": 1584718692,
			"type": "sms"
		}
	]
}

​
Workflow Library Example

List Telephony Logs with Duo and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop