---
title: "Generate a Data Export"
method: POST
path: "/exports"
tags: ["Data Exports"]
---

# Generate a Data Export

`POST /exports`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/exports`
- Auth: none declared

Generates an export. Use the data set `key` and each column `key` that you want to be included in your export. The values need to be properly formatted JSON, which means you may need to escape special characters. If no column keys are provided, the export will fail and return a 422 response.

**Example**
The following example creates a new export containing all the non-custom field columns for the User dataset created during October 2023.

```
curl -i -X POST 'https://api.mavenlink.com/api/v1/exports' -H 'Content-Type: application/json' -d '{
  "export": {
    "export_definition": {
      "8ebff9db413b3115": {
        "columns": [
          "4eb02f5e2601433d",
          "b02d7f145ad95122",
          "2bfa2c20999efe62",
          "96cb337e5007738b",
          "27e2565ae34ed9eb",
          "d5111608cc214c2a",
          "e59d1cb61256a8cf",
          "77bfd7e48d5ff668",
          "23ca4c0d7b289c5f",
          "7172de0607dcb1ef"
        ],
        "filters": {
          "start_date": "2023-10-01",
          "end_date": "2023-10-31"
        }
      }
    }
  }
}'
```


This endpoint returns structured Data Export objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `exports` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Query parameters

- `include` string

## Request body

- object
  - `export` object
    - `export_definition` object, required

## Response `200`

Data Export has been created.

- object
  - `count` integer
  - `meta` object
    - `count` integer
    - `page_count` integer
    - `page_number` integer
    - `page_size` integer
  - `results` object[]
    - `key` string
    - `id` string
  - `exports` object
  - `users` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)