Create Export

Attention

Please note that the Inbound/Outbound CDR export is available for current + 2 last months.

Creates a single Export. DIDWW performs deletion of CDR Export in 1 month after completion.

Request

HTTP Method: POST

URI Path: /v3/exports

Request Body Object Attributes

Name	Type	Nullable	Is Required?	Description
filters	CDR Export Filters Object	False	Yes	Filters
callback_url	string	True	No	The HTTP or HTTPS endpoint to where events related to export will be delivered.
callback_method	string	True	No	The HTTP Method used for export events. post and get are supported methods.
external_reference_id	string	True	No	Optional identifier for the export in the customer’s external system. Maximum length is 100 characters.

See Callback details for information about callback_url and callback_method.

Filters by Export Type

cdr_incdr_out

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.

Examples

Inbound CDR ExampleInbound CDR Example with CallbackOutbound CDR ExampleOutbound CDR Example with Callback

http

POST /v3/exports HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

{
  "data": {
    "type": "exports",
    "attributes": {
      "export_type": "cdr_in",
      "filters": {
        "from": "2025-12-01T00:00:00Z",
        "to": "2025-12-31T23:59:59Z",
        "did_number": "123456789"
      }
    }
  }
}

curl

curl -i -X POST https://api.didww.com/v3/exports -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json" --data-raw '{"data": {"attributes": {"export_type": "cdr_in", "filters": {"did_number": "123456789", "from": "2025-12-01T00:00:00Z", "to": "2025-12-31T23:59:59Z"}}, "type": "exports"}}'

response

HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{
  "data": {
    "id": "33bdfff7-4de3-4c58-8c90-b99930fb984a",
    "type": "exports",
    "attributes": {
      "status": "pending",
      "created_at": "2025-12-16T06:39:44.465Z",
      "external_reference_id": null,
      "url": null,
      "callback_url": null,
      "callback_method": null,
      "export_type": "cdr_in",
      "filters": {
        "from": "2025-12-01T00:00:00Z",
        "to": "2025-12-31T23:59:59Z",
        "did_number": "123456789"
      }
    }
  },
  "meta": {
    "api_version": "2026-04-16"
  }
}

Other Responses

Code	Success	Description
422	No	Unprocessable Entity
401	No	Unauthorized