{"_id":"58410872e807df0f0012cd30","parentDoc":null,"category":{"_id":"5841064b652e5b0f0015a7c8","version":"57624356653c2d2200fec79c","project":"55c8cff571d7580d0063a5e5","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-12-02T05:27:39.040Z","from_sync":false,"order":7,"slug":"call-logs","title":"Account Call Logs"},"project":"55c8cff571d7580d0063a5e5","user":"56f99ab84d2b4f3400edb636","version":{"_id":"57624356653c2d2200fec79c","__v":20,"project":"55c8cff571d7580d0063a5e5","createdAt":"2016-06-16T06:12:38.244Z","releaseDate":"2016-06-16T06:12:38.244Z","categories":["57624356653c2d2200fec79d","57624356653c2d2200fec79e","57624356653c2d2200fec79f","57624356653c2d2200fec7a0","57624356653c2d2200fec7a1","57624356653c2d2200fec7a2","57624356653c2d2200fec7a3","57624356653c2d2200fec7a4","57624356653c2d2200fec7a5","57624356653c2d2200fec7a6","57624356653c2d2200fec7a7","57624356653c2d2200fec7a8","57624356653c2d2200fec7a9","57624356653c2d2200fec7aa","5779ca1b99b40b0e005abb3a","5779d198aea88b0e00f63277","5797d3ab17ced017003c4be4","57ac170ef1cdae0e0053cdfc","57dbfc723ed3450e00dc9e6d","5804d12d16161c0f0077df9b","5841064b652e5b0f0015a7c8","588b5e5f2966b2230009cbf9","58a68ebf3239fa0f00857619","58c23c8b4922930f0050ac91","58fd1460809fc30f00f2ee07","5934eaf5328680002d77de6a","594bf91601cfe6000f40f4c5","595c4ed696b447001ba0cf6d","596524495cee50001575f5be","5970d4f1313162004dd303b5","59780fac24dbd1001a1fa057","59a8cfd3ead78a002d63cafe","59e0323d93da1f001c9ec170"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"4.0.0","version":"4"},"__v":5,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-12-02T05:36:50.070Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"<?php\n\n$curl = curl_init();\n\ncurl_setopt_array($curl, array(\n    CURLOPT_URL => \"https://api.phone.com/v4/accounts/453760/call-logs?filters%5Bstart_time%5D=gt%3A1490706958&sort%5Bstart_time%5D=asc\",\n    CURLOPT_RETURNTRANSFER => true,\n    CURLOPT_ENCODING => \"\",\n    CURLOPT_MAXREDIRS => 10,\n    CURLOPT_TIMEOUT => 30,\n    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,\n    CURLOPT_CUSTOMREQUEST => \"POST\",\n    CURLOPT_POSTFIELDS => \"\",\n    CURLOPT_HTTPHEADER => array(\n        \"authorization: Bearer ThisIsYourAPIToken\",\n        \"cache-control: no-cache\",\n        \"content-type: application/json\"\n    ),\n));\n\n$response = curl_exec($curl);\n$err = curl_error($curl);\n\ncurl_close($curl);\n\nif ($err) {\n    echo \"cURL Error #:\" . $err;\n} else {\n    echo $response;\n}","language":"php"}]},"method":"get","results":{"codes":[{"status":200,"language":"json","code":"{\n    \"filters\": {\n        \"start_time\": \"gt:1490706958\"\n    },\n    \"sort\": {\n        \"created_at\": \"asc\"\n    },\n    \"total\": 2,\n    \"offset\": 0,\n    \"limit\": 50,\n    \"items\": [\n        {\n            \"id\": \"07fc6c46-ee89-4d4c-bfc4-487255e755af\",\n            \"uuid\": null,\n            \"extension\": {\n                \"id\": 709038,\n                \"voip_id\": 453760,\n                \"name\": \"Home Extension\",\n                \"extension\": 18\n            },\n            \"caller_id\": \"+17329953252\",\n            \"called_number\": \"+17326830492\",\n            \"start_time\": \"2016-12-02T10:46:06-08:00\",\n            \"created_at\": \"2016-12-02T10:47:11-08:00\",\n            \"direction\": \"in\",\n            \"type\": \"call\",\n            \"call_duration\": 25,\n            \"record_duration\": 25,\n            \"is_monitored\": \"Y\",  \n            \"call_number\": \"1480704367.6064396\",\n            \"final_action\": \"Extension 18\",\n            \"details\": [\n                {\n                    \"start_time\": 1480704366,\n                    \"id_value\": 709038,\n                    \"type\": \"phone\",\n                    \"voip_id\": 453760,\n                    \"voip_phone_id\": 709038\n                }\n            ],\n            \"voicemail_url\": \"\",\n            \"voicemail_cp_url\": \"\",\n            \"voicemail_transcript\": \"\",\n            \"call_recording_url\": \"https://api.phone.com/v4/accounts/453760/call-logs/506f534b-abcd-4349-8cbc-9fb6f253f4e2/recording/download\",\n            \"call_recording_cp_url\": \"https://control.phone.com/voip/listen?document_id=59374298762aff52a86f9ad3;linked_uuid=506f534b-abcd-4349-8cbc-9fb6f253f4e2\",               \"caller_cnam\": \"\"\n        },\n        {\n            \"id\": \"47368681-baba-4fde-b763-5dd4b61188b9\",\n            \"uuid\": null,\n            \"extension\": {\n                \"id\": 709038,\n                \"voip_id\": 453760,\n                \"name\": \"Home Extension\",\n                \"extension\": 18\n            },\n            \"caller_id\": \"+17326830492\",\n            \"called_number\": \"+17327618767\",\n            \"start_time\": \"2016-12-02T10:09:55-08:00\",\n            \"created_at\": \"2016-12-02T10:43:19-08:00\",\n            \"direction\": \"out\",\n            \"type\": \"call\",\n            \"call_duration\": 1970,\n            \"record_duration\": 0,\n            \"is_monitored\": \"N\",\n            \"call_number\": \"1480702194.6653597\",\n            \"final_action\": \"dial_out +17327618767\",\n            \"details\": [\n                {\n                    \"caller_id\": \"+17326830492\",\n                    \"called_number\": \"+17327618767\",\n                    \"start_time\": 1480702195,\n                    \"type\": \"dial_out\",\n                    \"voip_id\": 453760,\n                    \"voip_phone_id\": 709038\n                }\n            ],\n            \"voicemail_url\": \"\",\n            \"voicemail_cp_url\": \"\",\n            \"voicemail_transcript\": \"\",\n            \"call_recording_url\": \"\",\n            \"call_recording_cp_url\": \"\",\n            \"caller_cnam\": \"\"\n        }\n    ],\n}","name":""}]},"settings":"","auth":"required","params":[{"_id":"56f9c28a5e9c512200d91b53","ref":"","in":"path","required":true,"desc":"Account ID","default":"","type":"int","name":"account_id"},{"_id":"56f9c28a5e9c512200d91b52","ref":"","in":"query","required":false,"desc":"ID filter.  Reference to this [link](doc:list-inputs#section-syntax-of-filters) for syntax of filters.","default":"","type":"array_string","name":"filters[id]"},{"_id":"5841c4deae05ac2500ba261e","ref":"","in":"query","required":false,"desc":"Call start time filter","default":"","type":"array_string","name":"filters[start_time]"},{"_id":"5841c4deae05ac2500ba261d","ref":"","in":"query","required":false,"desc":"Call log creation time filter","default":"","type":"string","name":"filters[created_at]"},{"_id":"5841c4deae05ac2500ba261c","ref":"","in":"query","required":false,"desc":"Call direction filter: `in` or `out`","default":"","type":"string","name":"filters[direction]"},{"_id":"58544864b322ef2f00db886a","ref":"","in":"query","required":false,"desc":"Called number","default":"","type":"string","name":"filters[called_number]"},{"_id":"58544864b322ef2f00db8869","ref":"","in":"query","required":false,"desc":"Call type, such as 'call', 'fax', 'audiogram'","default":"","type":"string","name":"filters[type]"},{"_id":"587e64ac9483ad25007c3c4f","ref":"","in":"query","required":false,"desc":"Account extension","default":"","type":"string","name":"filters[extension]"},{"_id":"56f9c28a5e9c512200d91b51","ref":"","in":"query","required":false,"desc":"ID sorting","default":"","type":"string","name":"sort[id]"},{"_id":"577f21d6a326490e000b749f","ref":"","in":"query","required":false,"desc":"Sorting by call start time: `asc` or `desc`","default":"","type":"string","name":"sort[start_time]"},{"_id":"5841c4deae05ac2500ba261b","ref":"","in":"query","required":false,"desc":"Sorting by call log creation time: `asc` or `desc`","default":"","type":"string","name":"sort[created_at]"},{"_id":"56f9c28a5e9c512200d91b50","ref":"","in":"query","required":false,"desc":"Max results","default":"","type":"int","name":"limit"},{"_id":"56f9c28a5e9c512200d91b4f","ref":"","in":"query","required":false,"desc":"Results to skip","default":"","type":"int","name":"offset"},{"_id":"573c6bf9f09c292200b398a5","ref":"","in":"query","required":false,"desc":"Field set: 'all' or '`brief`","default":"all","type":"string","name":"fields"}],"url":"/accounts/:account_id/call-logs"},"isReference":false,"order":1,"body":"[block:api-header]\n{\n  \"type\": \"basic\"\n}\n[/block]","excerpt":"Get a list of call details associated with your account.  See [Call Logs](doc:account-call-logs) for more detail.","slug":"list-account-call-logs","type":"endpoint","title":"List Call Logs"}

getList Call Logs

Get a list of call details associated with your account. See [Call Logs](doc:account-call-logs) for more detail.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

account_id:
required
integer
Account ID

Query Params

filters[id]:
array of strings
ID filter. Reference to this [link](doc:list-inputs#section-syntax-of-filters) for syntax of filters.
filters[start_time]:
array of strings
Call start time filter
filters[created_at]:
string
Call log creation time filter
filters[direction]:
string
Call direction filter: `in` or `out`
filters[called_number]:
string
Called number
filters[type]:
string
Call type, such as 'call', 'fax', 'audiogram'
filters[extension]:
string
Account extension
sort[id]:
string
ID sorting
sort[start_time]:
string
Sorting by call start time: `asc` or `desc`
sort[created_at]:
string
Sorting by call log creation time: `asc` or `desc`
limit:
integer
Max results
offset:
integer
Results to skip
fields:
stringall
Field set: 'all' or '`brief`

Examples


Result Format


Documentation

[block:api-header] { "type": "basic" } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}