[Tenjin API Reference](https://api-docs.tenjin.com/llms.txt) › [Raw Data Exports API](https://api-docs.tenjin.com/raw-data-exports-api.md) › List all data exports

- Raw Data Exports API OpenAPI spec: https://api-docs.tenjin.com/openapi/raw-data-exports-api.json

# List all data exports

- **Method:** `GET`
- **Path:** `/v1/exports`
- **Operation ID:** `get_exports`
- **Tags:** Raw Data Exports

Results are paginated and ordered newest first. Use the `page` and `per_page` query parameters to page through results; pagination metadata is returned in the response headers.

## Effective servers

- `https://api.tenjin.com/data_exports`

## Authentication

- **Bearer**: HTTP bearer (`JWT`)

  Generate an access token on the [Access Tokens](https://dashboard.tenjin.com/dashboard/access_tokens) page of the Tenjin dashboard and send it as `Authorization: Bearer <access token>`. [API access tokens](https://tenjin.com/docs/api-access-tokens/) explains them.

## Query parameters

- **`page`**: `integer`, default: `1`

  Page of results to fetch.
- **`per_page`**: `integer`, default: `25`, minimum: `0`, maximum: `1000`

  Number of results to return per page.

## Responses

### 200 Get all data exports for the current user

**Headers:**

- **`Link`**

  RFC 8288 pagination links (rel="first", "last", "next", "prev")

  `string`
- **`Total`**

  Total number of exports matching the request

  `integer`
- **`Per-Page`**

  Number of exports returned per page

  `integer`

**Content type:** `application/json`

**Array of:**

schema: `DataExport`

- **`ad_network_ids` (required)**: `array of integer`

  Ad Network IDs included in this export
- **`app_ids` (required)**: `array of string`

  App IDs included in this export
- **`created_at` (required)**: `string`, format: `date-time`

  Creation timestamp (ISO8601)
- **`end_date` (required)**: `string`, format: `date`

  End date (ISO8601)
- **`event_type_groups` (required)**: `array of string`

  Event type groups included in this export
- **`event_types` (required)**: `array of string`

  DEPRECATED — use event_type_groups
- **`expiration_date` (required)**: `string`, format: `date`

  DEPRECATED — use expires_at. Date portion of expires_at: the export expires during this UTC day, not at its end.
- **`expires_at` (required)**: `string`, format: `date-time`

  Exact expiry timestamp (ISO8601), 24 hours after creation. Downloads return 410 Gone after this; files are deleted shortly afterwards.
- **`files` (required)**: `array`

  Files available for download

  **Items:**

  schema: `FileInfo`

  Files available for download
  - **`download_url` (required)**: `string`

    API path that redirects (303) to a presigned S3 download URL
  - **`file_size` (required)**: `integer`
  - **`s3_uri` (required)**: `string`
- **`id` (required)**: `string`

  Export ID
- **`limited_rows` (required)**: `boolean`

  Whether row count was limited
- **`start_date` (required)**: `string`, format: `date`

  Start date (ISO8601)
- **`status` (required)**: `string`

  Current state (pending, processing, completed, failed)
- **`updated_at` (required)**: `string`, format: `date-time`

  Last update timestamp (ISO8601)

**Example:**

```json
[
  {
    "id": "",
    "status": "",
    "limited_rows": true,
    "app_ids": [
      ""
    ],
    "ad_network_ids": [
      1
    ],
    "event_type_groups": [
      ""
    ],
    "event_types": [
      ""
    ],
    "created_at": "",
    "updated_at": "",
    "start_date": "",
    "end_date": "",
    "expires_at": "",
    "expiration_date": "",
    "files": [
      {
        "s3_uri": "",
        "file_size": 1,
        "download_url": ""
      }
    ]
  }
]
```

### 401, 403, 422

- `401` Forbidden - Missing or invalid authentication
- `403` Unauthorized - Insufficient permissions
- `422` Invalid pagination parameters

**Content type:** `application/json`

schema: `Error`

- **`error` (required)**: `string`

  Error message (same as title, for backward compatibility)
- **`status` (required)**: `integer`

  HTTP status code
- **`title` (required)**: `string`

  Short, human-readable summary
- **`type` (required)**: `string`

  URI identifying the problem type
- **`detail`**: `string`

  Human-readable explanation specific to this occurrence

**Example:**

```json
{
  "error": "",
  "type": "",
  "title": "",
  "status": 1,
  "detail": ""
}
```

## Schemas

- `DataExport` — shown above.
- `Error` — shown above.
- `FileInfo` — shown above.