Create Export#

Attention

Please note that records of every export type can be exported only for the current month and the 2 previous months.

Creates a single Export of call or message records. DIDWW performs deletion of the Export in 1 month after completion.

Request#

HTTP Method: POST

URI Path: /v3/exports

Request Body Object Attributes#

Name

Type

Nullable

Is Required?

Description

export_type

string

False

Yes

Type of records to export. Possible values: cdr_in - inbound call records, cdr_out - outbound call records, sms_in - inbound message records, sms_out - outbound message records.

filters

Export Filters Object

False

Yes

Filters. The accepted keys depend on export_type.

callback_url

string

True

No

The HTTP or HTTPS endpoint to where events related to export will be delivered. Send it together with callback_method.

callback_method

string

True

No

The HTTP Method used for export events. post and get are supported methods. Send it together with callback_url.

external_reference_id

string

True

No

Optional identifier for the export in the customer’s external system. Maximum length is 100 characters.

See Export callback details for information about callback_url, callback_method, and the Export callback payload.

Filters by Export Type#

from and to are required for every export type. Send them as YYYY-MM-DD HH:MM:SS in UTC. from must be earlier than to, both must fall within the current month or the 2 previous months, and neither can be in the future. The Export returns them normalized to YYYY-MM-DD HH:MM:SS.

Every other filter is optional and matched exactly unless its description says otherwise. A filter that is sent must not be blank, and only the filters listed for the selected export type are accepted. Filters that accept several values take a single value or an array of values.

Name

Type

Is Required?

Description

from

string

Yes

Start date and time of the CDR range.

to

string

Yes

End date and time of the CDR range.

did_number

string

No

CDR export for a specified DID number. If the ‘did_number’ parameter is not used, CDRs are exported for all owned DID numbers.

source_number

string

No

CDR export for calls from this caller number, as it reached DIDWW.

source_number_out

string

No

CDR export for calls from this caller number, as delivered to the trunk.

source_country_iso

string

No

CDR export for calls from the country with this upper-case ISO 3166-1 alpha-2 code, for example GB.

Examples#

http

 1POST /v3/exports HTTP/1.1
 2Host: api.didww.com
 3Content-Type: application/vnd.api+json
 4Accept: application/vnd.api+json
 5Authorization: Bearer [access token]
 6
 7{
 8  "data": {
 9    "type": "exports",
10    "attributes": {
11      "export_type": "cdr_in",
12      "filters": {
13        "from": "2026-09-01 00:00:00",
14        "to": "2026-09-30 23:59:59",
15        "did_number": "123456789"
16      }
17    }
18  }
19}

curl

1curl -i -X POST https://api.didww.com/v3/exports -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]" --data-raw '{"data": {"attributes": {"export_type": "cdr_in", "filters": {"did_number": "123456789", "from": "2026-09-01 00:00:00", "to": "2026-09-30 23:59:59"}}, "type": "exports"}}'

response

 1HTTP/1.1 201 Created
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "33bdfff7-4de3-4c58-8c90-b99930fb984a",
 7    "type": "exports",
 8    "attributes": {
 9      "status": "pending",
10      "created_at": "2026-10-16T06:39:44.465Z",
11      "external_reference_id": null,
12      "url": null,
13      "callback_url": null,
14      "callback_method": null,
15      "export_type": "cdr_in",
16      "filters": {
17        "from": "2026-09-01 00:00:00",
18        "to": "2026-09-30 23:59:59",
19        "did_number": "123456789"
20      }
21    }
22  },
23  "meta": {
24    "api_version": "2026-11-19"
25  }
26}

Other Responses#

Code

Success

Description

422

No

Unprocessable Entity

400

No

Bad Request

401

No

Unauthorized

403

No

The access token carries the read scope, which does not cover this method (title Insufficient scope). The response carries WWW-Authenticate: Bearer error="insufficient_scope". See Scopes.

429

No

The request budget of the account for the current window is spent (too_many_requests). Retry-After gives the number of seconds to wait.