Get list of records
Overview
To get the list of the voice records for the account, make the GET request to /accounts/{accountSID}/recordings.
The results can be narrowed by specifying filtering parameters.
Request example
The following example demonstrates getting recordings logs.
curl –X GET https://api.apifonica.com/v2/accounts/{accountSID}/recordings \
-u {accountSID}:{authToken}
Response example
{
"limit": 20,
"prev": null,
"next": "https://api.apifonica.com/v2/accounts/{accountSID}//recordings?next=4771",
"recordings": [
{
"call_sid": "{callSID}",
"call_created": "Fri, 21 Apr 2017 13:01:25 +0000",
"account_sid": "{accountSID}",
"from": "358942417543",
"to": "79031550066",
"number_sid": "{numberSID}",
"direction": "outbound",
"record_created": "Fri, 21 Apr 2017 13:03:12 +0000",
"size": 8,
"price": 0.00010,
"exp_date": "Sat, 21 Apr 2018 13:03:12 +0000",
"record_sid": "rec17cb9958-3878-4562-b6a7-f67a0adsfsdfd",
"rec_url": "https://api.apifonica.com/v2/accounts/{accountSID}/recordings/rec17cb9958-3878-4562-b6a7-f67a0adsfsdfd.wav"
},
...
]
}
Response parameters
Parameter | Description |
---|---|
limit | A parameter describing how many records are returned per page. The default and maximum value is 20. |
prev | URI to the previous page. |
next | URI to the next page. |
recordings | A list of records. |
recordings/call_sid | Call identifier. |
recordings/call_created | Call creation date. 'dateFormat' => 'Thu, 07 Jul 2016 10:15:53 +0000' |
recordings/account_sid | Account identifier. |
recordings/from | Caller’s phone number. |
recordings/to | Recipient’s phone number. |
recordings/number_sid | Unique identifier of the number acquired from Apifonica and used for this call. |
recording/direction | Call Direction. |
recordings/record_created | Date of creation of the file with the record. 'dateFormat' => 'Thu, 07 Jul 2016 10:15:53 +0000'. |
recordings/size | The size of the file with the recording in MB. |
recordings/price | Total price of the record storage in EURO. |
recordings/exp_date | The expiration date of the file with the record. |
recordings/record_sid | System identifier associated with the record file. |
recordings/rec_url | Link to download a file with a record. |
Response filtering
The following curl request demonstrates getting a list of recordings made for outbound calls from the specified number.
curl –X GET https://api.apifonica.com/v2/accounts/{accountSID}/recordings?direction=outbound&number_sid={numberSID} \
-u {accountSID}:{authToken}
Filtering parameters
Parameter | Description |
---|---|
limit | A parameter describing how many records are returned per page. The default and maximum value is 20. |
prev | URI to the previous page. |
next | URI to the next page. |
call_sid | Call identifier. |
created_after | Records that were created after this date and time. 'dateFormat' => 'yyyy-MM - dd' |
created_before | Records that were created before this date and time. 'dateFormat' => 'yyyy-MM - dd' |
account_sid | Account identifier. |
to | Recipient’s phone number. |
from | Caller’s phone number. |
number_sid | Unique identifier of the number acquired from Apifonica and used for this call. |
direction | Call direction. Either inbound or outbound. |
days_left | Number of days before the expiration of the record. |