---
title: "View"
method: GET
path: "/exports/view"
tags: ["Exports"]
---

# View

`GET /exports/view`

Get information about an export request.

## Query parameters

- `id` string, required

## Headers

- `X-Batch-Project` string, required

## Response `200`

If the GET to the API endpoint is successful you will receive an HTTP 200 confirmation and information about your export request.

- Request
  - `id` string, required — Id of an export request.
  - `request_date` string — UTC date in a RFC 3339 format.
  - `completion_date` string — UTC date in a RFC 3339 format.
  - `start_date` string — UTC date in a RFC 3339 format.
  - `scope` 'PROFILE_ATTRIBUTES' | 'PROFILE_EVENTS', required
  - `status` 'CREATED' | 'PENDING' | 'RUNNING' | 'ERROR' | 'SUCCESS', required
  - `files` File[], required — All the extraction files available for download if any.
    - `id` string — Id of the extraction file available for download if any.
    - `part` integer — The part number of the file
    - `size` integer — Size of the file in bytes.
    - `url` string — URL to download the file.
  - `request` union, required — The export request definition.
    - object
      - `export_type` 'ATTRIBUTES', required — Type of the export events request.
      - `attributes` string[] — List of custom or native attributes to be included in the export file(s). Any value that does not start with a `$` will be interpreted as a custom attribute. A list of native attributes available is provided below: - `$city` - `$creation_date` - `$email_address` - `$email_marketing` - `$language` - `$last_activity` - `$last_email_marketing_click` - `$last_email_marketing_open` - `$last_email_transactional_click` - `$last_email_transactional_open` - `$last_visit_date` - `$phone_number` - `$region` - `$sms_marketing` - `$timezone` - `$push_subscriptions` - `$install_date` - `$email_open_tracking_consent` - `$topic_preferences` - `$device.device_model` - `$device.os_version`
      - `identifiers` string[] — List of profile identifiers to be included in the export file(s).
      - `filter` object — Optional filter to refine the export. A rate limit applies when using this parameter.
        - `segment` string — Code of the segment you want to filter this export with.
        - `include_unreachable` boolean — When set to `true`, the export includes all profiles in the database. By default (`false`), only profiles with at least one custom id, email address, phone number or push token are included.
    - object
      - `export_type` 'EVENTS', required — Type of the export events request.
      - `from` string, required — UTC date in a RFC 3339. Must be before `to` parameter and not older than the lookback period.
      - `to` string, required — UTC date in a RFC 3339 format or `now`.
      - `identifiers` string[] — List of profile identifiers to be included in the export file(s).
      - `events` string[], required — List of events to be included in the export file(s).
      - `orchestration_ids` string[] — List of orchestrations IDs to be exported. If not provided, all orchestrations will be exported.

## Other responses

- `400` — The request is malformed
- `401` — The Rest API Key is not valid for this project
- `404` — Not found
- `429` — Too Many Requests
- `500` — Unexpected error
- `503` — Batch's services are under maintenance. Please try again later

---

[API](https://skmtc.net/batch/apis/batch-rest-api.md) · [All operations](https://skmtc.net/batch/apis/batch-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/batch/batch-rest-api/revisions/ec696334ff35/schema)