Get CSV File of Export

Returns a single .csv.gz file for corresponding Export.

Attention

Please note that the file is available for Download Only! It can not be read as in previous versions due to .csv file being Archived as .gz format archive for compression of space.
To receive the CDR export file, a query should be sent to /v3/exports/{filename}.csv.gz, and the {filename} can be obtained from the response of Get Exports URL attribute or Get Export following by export ID.

Exported File Format

The exported file contains call detail records (CDRs) in CSV format.

Inbound CDRs

Inbound CDR sample

Column

Type

Description

Date/Time Start (UTC)

string

Call start timestamp in UTC.

Date/Time Connect (UTC)

string

Call answer timestamp in UTC.

Date/Time End (UTC)

string

Call end timestamp in UTC.

Status

string

Call status.

Source

string

Source number.

Source Name

string

Caller name.

Destination DID

string

Destination DID number.

Duration (sec)

integer

Call duration in seconds.

Attempt

integer

Call attempt number.

Disconnect Code

string

Disconnect code.

Response

string

SIP response or system response.

Disconnect Initiator

string

Entity that initiated call termination.

Voice IN Trunk

string

Voice In trunk identifier or name.

Destination

string

Destination number.

Trunk Group

string

Associated trunk group.

Capacity Group

string

Associated capacity group.

Toll-free (USD)

string

Toll-free cost in USD.

PSTN (USD)

string

PSTN cost in USD.

Metered (USD)

string

Metered cost in USD.

CNAM IN (USD)

string

CNAM lookup cost in USD.

Total (USD)

string

Total cost in USD.

Call ID

string

Unique call identifier.

Outbound CDRs

Outbound CDR sample

Column

Type

Description

Date/Time Start (UTC)

string

Call start timestamp in UTC.

Date/Time Connect (UTC)

string

Call answer timestamp in UTC.

Date/Time End (UTC)

string

Call end timestamp in UTC.

Status

string

Call status.

Source

string

Source number.

CLI

string

Calling Line Identification.

Destination Number

string

Destination number.

Call Duration (sec)

integer

Call duration in seconds.

Billing Duration (sec)

integer

Billed duration in seconds.

Disconnect Code

string

Disconnect code.

Disconnect Reason

string

Disconnect reason description.

Voice OUT Trunk

string

Voice Out trunk identifier or name.

Destination Country

string

Destination country.

Network

string

Destination network.

Call Type

string

Call type classification.

Rate (USD)

string

Rate per unit in USD.

Charged (USD)

string

Charged amount in USD.

P-Charge-Info

string

Charging information header.

Call ID

string

Unique call identifier.

Request

HTTP Method: GET

URI Path: /v3/exports/{filename}.csv.gz

Note

For all returned data attributes, see Export Object.

URI Parameters

Name

Type

Is Required?

Description

filename

string

Yes

Unique filename of completed CDR Export.

Examples

http

GET /v3/exports/a4f6b765-f20c-45c7-98d2-80c2f3a41517.csv.gz HTTP/1.1
Host: api.didww.com
Api-Key: [API token]

curl

curl -i -X GET https://api.didww.com/v3/exports/a4f6b765-f20c-45c7-98d2-80c2f3a41517.csv.gz -H "Api-Key: [API token]"

Other Responses

Code

Success

Description

404

No

Not Found (without body)

401

No

Unauthorized