Skip to main content

How to Use Reporting and Export API Endpoints

Retrieve reporting and export data directly from Ventrata using dedicated endpoints.

Updated this week

Overview

Access any data table available in the Backoffice using your dashboard API Token via these endpoints:

  • POST /ventrata/dashboard/report

  • POST /ventrata/dashboard/export

These endpoints allow you to generate the same reports and exports available in the Ventrata Backoffice—programmatically. This provides a clean and flexible way to integrate reporting and data exports into your own systems.


Prerequisites:

  • Create a dashboard mode connection.

  • Add ventrata/dashboard to your list of capabilities.

📗 TIP

If you are unsure how to create a dashboard mode connection, please contact your Ventrata Success Manager.


Reporting API

The /report endpoint returns custom reports as an array of JSON objects.

  1. In your Ventrata dashboard, go to any data table (for example, Bookings, Transactions, etc.).

  2. Press the Generate Report link in the action bar.

    Generate Report

  3. Press the Reporting API cURL link to download the request body.

    Reporting API cURL

  4. Open the .curl file and:

    • Replace the 'Authorization' header with your dashboard token.

      Dashboard Token - API Key

      .curl file - Authorization header

    • (Optional) Modify the filters object to dynamically insert values.

      .curl file - Filters

  5. Once submitted, the API will return the full report data in JSON format.

📗 TIP

To include all the necessary filters, we recommend first generating the report manually from the dashboard. Then press the Reporting API cURL link below the generated report. This will automatically include all applied filters in the request body.

Reporting API cURL


Exporting API

The /export endpoint lets you download raw data exports (for example, bookings, payments, tickets), also as an array of JSON objects.

  1. In the Ventrata dashboard, go to any data table in the dashboard (for example, Bookings, Transactions, etc.).

  2. Press the Export link in the action bar.

  3. Press Download Export API cURL to download the request body.

    Export

  4. Open the .curl file and:

    • Replace the 'Authorization' header with your dashboard token

      Dashboard Token - API Key

      .curl file - Authorization header

    • (Optional) Modify the filters object to fit your integration needs.

      .curl file - Filters

  5. The API will return a JSON array with your requested export data.


Available Data

Every table and column available in the Backoffice is also available through these API endpoints, including but not limited to:

Did this answer your question?