# Get Exports

Returns a collection of Exports.

## Request

HTTP Method: `GET`

URI Path: `/v3/exports`

Note

For all returned data attributes, see [Export Object](export-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| filter[<filter\_name>] | `string` | No | [Filtering](../../specification/filtering.html#api-filters) |
| fields[exports] | `string` | No | [Sparse fieldsets](../../specification/sparse-fieldsets.html#api-sparse-fieldsets) |
| sort | `string` | No | [Sorting](../../specification/sorting.html#api-sorting) |
| page[number] | `integer` | No | [Page number](../../specification/pagination.html#api-pagination). |
| page[size] | `integer` | No | [Page size](../../specification/pagination.html#api-pagination). |

### Filters

The `external_reference_id` filter applies to all export types. Other filters differ depending on the `export_type`
[Data attribute](#get-exports-v34-data-attributes).

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| external\_reference\_id | `string` | No | No | The `external_reference_id` field. |

cdr\_incdr\_out

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| from | `string` | No | No | The start date and time of the CDR range. |
| to | `string` | No | No | The end date and time of the CDR range. |
| did\_number | `string` | Yes | No | The DID number used to filter inbound CDR exports. |

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| from | `string` | No | No | The start date and time of the CDR range. |
| to | `string` | No | No | The end date and time of the CDR range. |
| voice\_out\_trunk.id | `string` | Yes | No | The outbound trunk identifier used to filter outbound CDR exports. |

### Sorting

| Value | Description |
| --- | --- |
| status | The `status` field. Possible values: `pending`, `processing`, `completed`. |
| created\_at | The `created_at` field. |

## Examples

cdr\_incdr\_out

[[DIDWW-API-EXAMPLE-START]]

http

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

curl

```
curl -i -X GET https://api.didww.com/v3/exports -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "6fee87b1-5f86-470c-80ca-9c3922653de9",
      "type": "exports",
      "attributes": {
        "status": "processing",
        "created_at": "2025-12-13T20:02:07.798Z",
        "external_reference_id": null,
        "url": null,
        "callback_url": null,
        "callback_method": null,
        "export_type": "cdr_in",
        "filters": {
          "from": "2025-12-01 00:00:00",
          "to": "2025-12-31 23:59:59",
          "did_number": "123456789"
        }
      }
    },
    {
      "id": "33bdfff7-4de3-4c58-8c90-b99930fb984a",
      "type": "exports",
      "attributes": {
        "status": "processing",
        "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-01 00:00:00",
          "to": "2025-12-31 23:59:59",
          "did_number": "123456789"
        }
      }
    },
    {
      "id": "d4f37476-8ece-4add-bbcb-cc72a7908fe2",
      "type": "exports",
      "attributes": {
        "status": "processing",
        "created_at": "2025-12-16T06:54:30.122Z",
        "external_reference_id": null,
        "url": null,
        "callback_url": "http://example.com",
        "callback_method": "get",
        "export_type": "cdr_in",
        "filters": {
          "from": "2025-12-01 00:00:00",
          "to": "2025-12-31 23:59:59",
          "did_number": "123456789"
        }
      }
    }
  ],
  "meta": {
    "total_records": 3,
    "api_version": "2026-04-16"
  },
  "links": {
    "first": "https://api.didww.com/v3/exports?page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "last": "https://api.didww.com/v3/exports?page%5Bnumber%5D=1&page%5Bsize%5D=50"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

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

curl

```
curl -i -X GET https://api.didww.com/v3/exports -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"
```

response

```
HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": [
    {
      "id": "88a29a27-11fe-4db0-a508-eca1d7cf0b68",
      "type": "exports",
      "attributes": {
        "status": "completed",
        "created_at": "2025-12-21T07:37:13.085Z",
        "external_reference_id": null,
        "url": "https://api.didww.com/v3/exports/a8bf7c0e-0c08-44ca-b0e2-db34a1d2006a.csv.gz",
        "callback_url": null,
        "callback_method": null,
        "export_type": "cdr_out",
        "filters": {
          "from": "2025-12-01 00:00:00",
          "to": "2025-12-31 23:59:59",
          "voice_out_trunk.id": "457bf47d-446d-41cd-91c3-dfbda7bf0753"
        }
      }
    },
    {
      "id": "67e4f27f-d5eb-4b80-8924-39486aee6ed4",
      "type": "exports",
      "attributes": {
        "status": "completed",
        "created_at": "2025-12-21T07:42:02.546Z",
        "external_reference_id": null,
        "url": "https://api.didww.com/v3/exports/b15d6a4b-3c99-4bee-af6b-f5f37ce30511.csv.gz",
        "callback_url": "http://example.com",
        "callback_method": "get",
        "export_type": "cdr_out",
        "filters": {
          "from": "2025-12-01 00:00:00",
          "to": "2025-12-31 23:59:59",
          "voice_out_trunk.id": "457bf47d-446d-41cd-91c3-dfbda7bf0753"
        }
      }
    },
    {
      "id": "77165c85-0a37-43d1-b3f8-c76d2eb50315",
      "type": "exports",
      "attributes": {
        "status": "completed",
        "created_at": "2025-12-21T07:54:35.789Z",
        "external_reference_id": null,
        "url": "https://api.didww.com/v3/exports/94593896-818a-4a00-b89b-e4d825f4c0d5.csv.gz",
        "callback_url": "http://example.com",
        "callback_method": "get",
        "export_type": "cdr_out",
        "filters": {
          "from": "2025-12-01 00:00:00",
          "to": "2025-12-31 23:59:59",
          "voice_out_trunk.id": "457bf47d-446d-41cd-91c3-dfbda7bf0753"
        }
      }
    }
  ],
  "meta": {
    "total_records": 3,
    "api_version": "2026-04-16"
  },
  "links": {
    "first": "https://api.didww.com/v3/exports?page%5Bnumber%5D=1&page%5Bsize%5D=50",
    "last": "https://api.didww.com/v3/exports?page%5Bnumber%5D=1&page%5Bsize%5D=50"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 401 | No | [Unauthorized](../../configuration.html#api-key) |

On this page