Reports API

The Reports API provides read-only access to business analytics and performance metrics.

Available Reports

Report	Description	Best For
Overview	High-level sales and booking stats	Executive dashboards
Rentals	Product rental performance	Inventory analysis
Experiences	Tour/activity performance	Activity optimization

Time Periods

All reports support three time periods:

Period	Description
today	Current day only
last_7_days	Previous 7 days
last_30_days	Previous 30 days

API Endpoints

Read-only, except custom reports

The built-in reports are read-only aggregated data. Custom reports can also be created and changed.

Method	Endpoint	Description	Scope Required
GET	/v1/reports/overview	Sales and booking summary	reports:read
GET	/v1/reports/rentals	Rental product metrics	reports:read
GET	/v1/reports/experiences	Experience metrics	reports:read
GET	/v1/reports/custom	Reports the business built itself (create and change with reports:write)	reports:read

Overview Report

High-level business metrics:

Overview Report
├── Sales
│   ├── Total revenue
│   ├── Transaction count
│   └── Average transaction value
├── Bookings
│   ├── Total created
│   ├── Confirmed / Completed / Cancelled
└── Customers
    ├── New customers
    └── Returning customers

Rentals Report

Product rental performance:

Rentals Report
├── Summary
│   ├── Total revenue
│   ├── Total bookings
│   ├── Average rental duration
│   └── Utilization rate
├── By Category
│   └── Revenue, bookings, items per category
└── Top Products
    └── Revenue, bookings, units rented per product

Experiences Report

Tour and activity performance:

Experiences Report
├── Summary
│   ├── Total revenue
│   ├── Total bookings
│   ├── Total participants
│   ├── Average group size
│   └── Capacity utilization
├── By Category
│   └── Revenue, bookings, participants per category
└── Top Experiences
    └── Revenue, bookings, utilization per experience

Common Use Cases

Building a Dashboard

Fetch overview data for your dashboard:

curl "https://app.equipdash.com/api/v1/reports/overview?period=last_7_days" \
  -H "Authorization: Bearer YOUR_API_KEY"

Analyzing Product Performance

Identify your best-performing rentals:

curl "https://app.equipdash.com/api/v1/reports/rentals?period=last_30_days" \
  -H "Authorization: Bearer YOUR_API_KEY"

Tracking Tour Capacity

Monitor experience utilization:

curl "https://app.equipdash.com/api/v1/reports/experiences?period=last_30_days" \
  -H "Authorization: Bearer YOUR_API_KEY"

Key Metrics Explained

Metric	Description
utilization_rate	% of inventory/capacity actually used
average_rental_duration	Average days per rental
average_group_size	Average participants per experience booking
capacity_utilization	% of available experience spots filled

Related Resources

• Bookings - Raw booking data for custom reports
• Products - Product details
• Experiences - Experience details