Samna

Appearance

Activity ​

Activity provides usage analytics and reporting across all resources. Each activity answers a specific question about how bookables are used: which resources are underutilized, when peak demand occurs, how booking patterns change over time, and how presence compares to reservations.

Each activity is a discrete endpoint under /activity. Most accept a date range and optional filters for organization, location, and bookable type. The available activities are listed below.

Available Activities ​

bookables_by_usage ​

Resources ranked by booking count and total booked hours.

bookable_utilization_rate ​

Percentage of available time that is booked per resource, with full organization and bookable type context.

bookable_avg_duration ​

Average, minimum and maximum booking length per resource, alongside total minutes booked.

bookable_peak_times ​

Time windows with highest booking density per resource, broken down by day of week.

bookable_offpeak_times ​

Time windows with lowest booking density per resource, broken down by day of week.

bookable_idle_times ​

Windows where resources sit unused even though they are available. Useful for detecting wasted capacity.

bookable_types_by_usage ​

Resource categories ranked by total bookings, with per type aggregate booking and utilization metrics.

underutilized_resources ​

Resources below a utilization threshold, with idle metrics and potential cost recovery.

locations_by_usage ​

Sites ranked by booking count, with parent location context.

location_peak_times ​

High demand windows per location, including how many of the site's bookables are in use during each window.

location_offpeak_times ​

Low demand windows per location.

Top individual resources at each site, ranked by demand.

Top resource categories at each site.

organizations_by_usage ​

Companies ranked by booking count, with parent organization context and unique user counts.

users_by_usage ​

Users ranked by booking volume within the period, with the full samna_auth user object when available.

total_bookings_by_period ​

Booking volume bucketed over time, with the most active resource, location, organization and bookable type for each bucket.

The single time window with the highest demand, expressed as a labeled period. period_type is one of time_of_day, day_of_week, month or day_of_year.

object_totals ​

Count of each top level object type in the system, with active and accessible counts. object_type is one of organization, bookable, location, bookable_type or user.

concurrent_bookings ​

Peak, average and accumulated count of bookings active at the same time per location. accumulated_cb is the Enterprise pricing metric.

API ​

The Activity tag of the Bookable API exposes the discovery endpoint at GET /activity and one endpoint per activity at GET /activity/{function}.