Experiences Report

Get detailed experience/tour performance metrics.

Endpoint

GET /v1/reports/experiences

Authentication

Requires an API key with the reports:read scope.

Query Parameters

Parameter	Type	Default	Description
period	string	today	Time period: today, last_7_days, last_30_days

Response

Success (200 OK)

{
  "data": {
    "period": "last_30_days",
    "period_label": "Last 30 Days",
    "summary": {
      "total_revenue": 12800.00,
      "total_bookings": 98,
      "total_participants": 245,
      "average_group_size": 2.5,
      "capacity_utilization": 72.3
    },
    "by_category": [
      {
        "category_id": 1,
        "category_name": "Water Activities",
        "revenue": 7200.00,
        "bookings": 55,
        "participants": 138
      },
      {
        "category_id": 2,
        "category_name": "Adventure Tours",
        "revenue": 3800.00,
        "bookings": 28,
        "participants": 72
      },
      {
        "category_id": 3,
        "category_name": "Classes & Lessons",
        "revenue": 1800.00,
        "bookings": 15,
        "participants": 35
      }
    ],
    "top_experiences": [
      {
        "id": 1,
        "name": "Sunset Kayak Tour",
        "revenue": 3900.00,
        "bookings": 30,
        "participants": 75,
        "average_group_size": 2.5,
        "capacity_utilization": 85.0
      },
      {
        "id": 2,
        "name": "Surf Lesson",
        "revenue": 2400.00,
        "bookings": 24,
        "participants": 30,
        "average_group_size": 1.25,
        "capacity_utilization": 62.5
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-01-15T12:00:00+00:00"
  }
}

Response Fields

Summary Object

Field	Type	Description
total_revenue	float	Total experience revenue
total_bookings	integer	Number of experience bookings
total_participants	integer	Total participants
average_group_size	float	Average booking group size
capacity_utilization	float	Capacity utilization percentage

By Category

Field	Type	Description
category_id	integer	Category ID
category_name	string	Category name
revenue	float	Revenue from category
bookings	integer	Number of bookings
participants	integer	Total participants

Top Experiences

Field	Type	Description
id	integer	Experience ID
name	string	Experience name
revenue	float	Total revenue
bookings	integer	Number of bookings
participants	integer	Total participants
average_group_size	float	Average group size
capacity_utilization	float	Capacity utilization %

Errors

Status	Code	Description
401	authentication_required	No API key provided
403	insufficient_scope	API key lacks reports:read scope

Example Request

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