Docs

Get list of records

https://api.apifonica.com/v2/accounts/{accountSID}/recordings

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

Description

A parameter describing how many records are returned per page.

The default and maximum value is 20.

Description

URI to the next page.

Description

URI to the previous page.

Description

A list of records.

Description

Call identifier.

Description

Call creation date.

Description

Account identifier.

Description

Recipient’s phone number.

Description

Caller’s phone number.

Description

Unique identifier of the number acquired from Apifonica and used for this call.

Description

Call direction.

Either inbound or outbound.

Description

Date of creation of the file with the record. 'dateFormat' => '"Thu, 07 Jul 2016 10:15:53 +0000"'.

Description

The size of the file with the recording in MB.

Description

Total price of the record storage in EURO.

Description

System identifier associated with the record file.

Description

The expiration date of the file with the record.

Description

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 you want to return 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

Description

A parameter describing how many records you want to return per page. The default and maximum value is 20.

Description

URI to the previous page.

Description

URI to the next page.

Description

Call identifier.

Description

Calls that were created after this date and time.

Description

Calls that were created before this date and time.

Description

Account identifier.

Description

Recipient’s phone number.

Description

Caller’s phone number.

Description

Call direction.

Either inbound or outbound.

Description

Call status.

One of the following:

queued, initiated, ringing, answered,

completed, no_answer, busy, rejected, failed, modified.