> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Telephony Logs
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 Documentation
To learn more, visit the [Duo documentation](https://duo.com/docs/adminapi#telephony-logs).
## Basic Parameters
| Parameter | Description |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| Maximum Time | Retrieve logs that have a timestamp of `Maximum Time` or earlier.
This value must be strictly greater then `Minimum Time`. |
| Minimum Time | Retrieve logs that have a timestamp of `Minimum Time` or later.
This value must be strictly less then `Maximum Time`. |
## Advanced Parameters
| Parameter | Description |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Limit | The maximum number of records to retrieve. Defaults to `100`, with maximum value of `1000`. |
| Next Offset | The 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. |
| Sort | The order in which to return the logs. |
## Example Output
```json theme={"dark"}
{
"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](https://library.blinkops.com/workflows/list-telephony-logs-with-duo-and-send-results-via-email)
Preview this Workflow on desktop