# List booths **GET /api/booths** Allows you to retrieve a paginated list of booths under your account. ## Servers - http://localhost:4000: http://localhost:4000 () ## Authentication methods - Api key ## Parameters #### Query parameters - **filter** (string) criteria to filter by - **sort** (string) criteria to sort by - **search** (string) criteria to search by - **limit** (string) amount of results per page to return - **page** (string) page number - **start** (string) ISO8601 formatted datetime to include booth utilization data since - **includes** (string) optional features to include. This is a list of values separated by colons ':'. The avaiable values are: cycle_count (adds cycles_count), utilization_times (adds utilization_minutes and working_minutes), energy_usage (adds kwh_usage and gas_usage), bake_time, and overuse_data (adds overuse_minutes and overuse_cycles) - **end** (string) ISO8601 formated datetime to include booth utilization data until ## Responses ### 200: OK #### Body Parameters: application/json (object) - **data** (array[object]) Booth data - **limit** (number) The number of items per page currently applied - **page** (number) The number of the page returned - **pages** (number) The total number of pages matching the current search - **total** (number) The total number of accounts matching the query ### 401: Unauthorized #### Body Parameters: application/json (object) - **error** (string) Human readable version of the error status code [Powered by Bump.sh](https://bump.sh)