> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Request Raw Data Export

Airbridge's data export feature allows you to select and extract raw data from your marketing campaigns into a .csv file. Begin exporting via \[Raw Data > Data Export]. Raw Data Export is available for App and Web in a separate section.

Request a Raw Data Export.

rate limit: 100 requests per day.

<Card title="Try API Request" icon="rectangle-api" horizontal href="https://www.postman.com/airbridge-engineering/workspace/airbridge-api/request/22395869-0cdb8bc7-2677-4f41-8e1b-4529081ed524" />

```text POST theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
https://api.airbridge.io/log-export/api/v3/apps/{app_name}/{type}/request
```

<h2 id="request-raw-data-export-request">
  Request
</h2>

***

<h3 id="request-raw-data-export-body-params">
  Body Params
</h3>

<ParamField body="dateRange" type="object" required>
  Set the data export period.

  <Expandable title="child attributes">
    <ParamField body="dateRange.start" type="string" required>
      The start date of the report data to request.

      * The date must be in the format 'YYYY-MM-DD HH:mm:ss'
      * This date must correspond with the timezone set in the Airbridge app.
      * The system only accepts dates within the 179 days preceding the current date. Future dates are not permitted.
    </ParamField>

    <ParamField body="dateRange.end" type="string" required>
      The end date of the report data to request.

      * The date must be in the format 'YYYY-MM-DD HH:mm:ss'
      * This date must correspond with the timezone set in the Airbridge app.
      * The system only accepts dates up the current date. The time period available for querying is up to 31 days.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="events" type="string[]" required>
  The event to be extracted. ([App Event Key](https://docs.google.com/spreadsheets/d/13ThNnryqRmZQwJVecM8lZ2OB7LzA8s3cwLlQBGpbXLg/edit#gid=959785444\&range=B:B), [Web Event Key](https://docs.google.com/spreadsheets/d/13ThNnryqRmZQwJVecM8lZ2OB7LzA8s3cwLlQBGpbXLg/edit#gid=1272078068\&range=B:B))
</ParamField>

<ParamField body="properties" type="string[]" required>
  The Property to be extracted. ([App Event Properties](https://docs.google.com/spreadsheets/d/13ThNnryqRmZQwJVecM8lZ2OB7LzA8s3cwLlQBGpbXLg/edit#gid=723627948\&range=B:B), [Web Event Properties](https://docs.google.com/spreadsheets/d/13ThNnryqRmZQwJVecM8lZ2OB7LzA8s3cwLlQBGpbXLg/edit#gid=253177103\&range=B:B))
</ParamField>

<ParamField body="filters" type="object[]">
  The filter for providing 'group by' items.

  <Expandable title="child attributes">
    <ParamField body="filters[0].field" type="string">
      The Properties to filter by.
    </ParamField>

    <ParamField body="filters[0].condition" type="object">
      <Expandable title="child attributes">
        <ParamField body="filters[0].condition.type" type="enum" required>
          The operator to apply to the filter.

          | Value       | Description                 |
          | ----------- | --------------------------- |
          | `equal`     | Equals (is, =)              |
          | `not_equal` | Does not equal (is not, ≠). |
          | `in`        | In                          |
          | `not_in`    | Not in                      |
          | `exist`     | Value exists                |
          | `not_exist` | Value does not exist        |
          | `lt`        | Less than                   |
          | `lte`       | Less than or equals         |
          | `gt`        | Greater than                |
          | `gte`       | Greater than or equals      |
          | `between`   | Between                     |
        </ParamField>

        <ParamField body="filters[0].condition.value" type="string" required>
          The value to apply to the filter. Used when the type is "equal", "not\_equal", "lt", "lte", "gt", "gte".
        </ParamField>

        <ParamField body="filters[0].condition.values" type="string[]" required>
          The value to apply to the filter. Used when the type is "in", "not\_in".
        </ParamField>

        <ParamField body="filters[0].condition.start" type="string" required>
          Start date if type is `between`.
        </ParamField>

        <ParamField body="filters[0].condition.end" type="string" required>
          End date if type is `between`.
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```shellscript Request theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  curl -X POST 'https://api.airbridge.io/log-export/api/v3/apps/{app_name}/{type}/request' \
    -d '{
    "dateRange": {
      "start": "2023-01-01 01:00:00",
      "end": "2023-01-07 01:00:00"
    },
    "events": [
      "app_install"
    ],
    "properties": [
      "channel"
    ]
  }'
  ```
</RequestExample>

<h2 id="request-raw-data-export-response">
  Response
</h2>

***

### 200

### 404

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "at": 1541410684717,
    "data": {
      "reportID": 2500
    }
  }
  ```

  ```json 404 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "type": "about:blank",
    "title": "Not Found",
    "status": 404,
    "traceId": "1-000000-000000000000000"
  }
  ```
</ResponseExample>