# Get the bucketed utilization of all booths within scope

**GET /api/bucketed_utilization**

Allows you to retrieve the bucketed utilization stats of one or multiple booths. Per facility, account, region, and others.


## Servers
- http://localhost:4000: http://localhost:4000 ()


## Authentication methods
- Api key


## Parameters


### Query parameters
- **filter** (string)
  criteria to filter by. Can be an account, facility, region, or booth id. If empty returns for all booths in scope
- **interval** (string)
  Interval size of each data point in days
- **group_by** (string)
  One of `day`, `week`, `month`, `quarter`. Can not be used with `interval`. Groups buckets by the given calendar interval.
- **start** (string)
  ISO8601 formatted date to query data from
- **end** (string)
  ISO8601 formatted date to query data until


## Responses
### 200
OK

#### Body: application/json (object)
- **data** (array[object])
  Booths utilization data

### 400
Bad Request

#### Body: application/json (object)
- **error** (string)
  Human readable version of the error status code

### 401
Unauthorized

#### Body: application/json (object)
- **error** (string)
  Human readable version of the error status code


[Powered by Bump.sh](https://bump.sh)