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

# Data Export

> Export message data from your Duck mesh network for analysis, reporting, and archival

The Data Export page allows you to filter and download historical message data from your Duck mesh network in CSV format for external analysis or archival purposes.

## Overview

Use the Data Export tool to:

* Extract specific time ranges of message data
* Filter by Papa Duck gateways, Mama Duck nodes, and message types
* Preview and refine data before downloading
* Export to CSV format for use in spreadsheets or analysis tools

## Setting Up Your Export

<Steps>
  <Step title="Select Date Range">
    Choose the start and end dates (and times) for your data export
  </Step>

  <Step title="Filter by Papa Ducks (Optional)">
    Select specific Papa Duck gateways, or leave empty to include all devices
  </Step>

  <Step title="Click Search">
    Click the **Search** button to load the matching data
  </Step>

  <Step title="Refine Results (Optional)">
    Use the Mama Duck and Message Type filters to narrow down the results
  </Step>

  <Step title="Review Preview">
    Check the data table to ensure you're exporting the correct information
  </Step>

  <Step title="Export to CSV">
    Click the **Export CSV** button to download the data
  </Step>
</Steps>

## Filter Options

### Date Range Selection

<Accordion title="Start Date & Time">
  Select the beginning date and time for your export range. Use the 24-hour time picker to set a precise start time.
</Accordion>

<Accordion title="End Date & Time">
  Select the ending date and time for your export range. Use the 24-hour time picker to set a precise end time.
</Accordion>

<Warning>
  **Date range limit**: Exports are limited to a maximum of 90 days. If you need data for a longer period, create multiple exports with consecutive date ranges.
</Warning>

### Papa Duck Filter

The multi-select dropdown allows you to choose which Papa Duck gateways to include:

* **All Papa Ducks** (default): Leave the selection empty to include all devices
* **Specific Papa Ducks**: Select one or more Papa Ducks to filter messages from only those gateways

<Info>
  Filtering by Papa Duck includes all messages from both the Papa Duck itself and its connected Mama Duck devices.
</Info>

### Refine Filters

After running a search, two additional filters appear to help you narrow down the results. These filters are populated dynamically based on what was found in your search — only devices and message types actually present in the results will be shown.

<Accordion title="Mama Duck Filter">
  Select one or more Mama Duck nodes to show only messages from those specific devices. Leave empty to include all nodes in the results.
</Accordion>

<Accordion title="Message Type Filter">
  Select one or more message types to show only those events. Available types include GPS, Health, Status, Sensor, BMP (covers BMP180, BMP280, and BMP390), and DHT — only types present in your results will appear.
</Accordion>

The record count at the top of the results updates as you apply refine filters, showing how many messages match your current selection versus the total returned (e.g., **42 / 200 messages**).

<Tip>
  Use **Reset** to clear all filters and start a new search.
</Tip>

## Data Preview Table

After clicking Search, the table displays a preview of your filtered data:

### Table Columns

| Column         | Description                                         |
| -------------- | --------------------------------------------------- |
| **Gateway**    | Name of the Papa Duck gateway                       |
| **Node**       | Name of the message sender (Papa or Mama Duck)      |
| **Event Type** | Type of message (GPS, Health, Status, Sensor, etc.) |
| **Date**       | Message timestamp in `YYYY-MM-DD HH:mm:ss` format   |
| **Message ID** | Unique identifier for each message                  |
| **Payload**    | Message content or sensor data                      |
| **# of Hops**  | Number of mesh network hops the message traveled    |

## Exporting Data

Once you've reviewed the preview and confirmed it contains the data you need:

<Steps>
  <Step title="Verify Data">
    Check the preview table and record count to ensure the correct data is selected
  </Step>

  <Step title="Click Export CSV">
    Click the **Export CSV** button in the table header
  </Step>

  <Step title="Download File">
    Your browser will download a CSV file with a descriptive filename that reflects your applied filters, for example:

    `data-export_from-20260401_to-20260430_gateways-2_nodes-3_types-2.csv`
  </Step>

  <Step title="Open in Analysis Tool">
    Open the CSV file in Excel, Google Sheets, or your preferred data analysis tool
  </Step>
</Steps>

### Public API

<CardGroup cols={1}>
  <Card title="Check out our API" icon="code" href="/api-reference/introduction">
    Explore the full public API — click here for documentation and integration guides.
  </Card>
</CardGroup>