# Hotspotsystem

HotspotSystem provides public Wi-Fi hotspot management and billing services for businesses.

- **Category:** internet of things
- **Auth:** API_KEY
- **Tools:** 16
- **Triggers:** 0
- **Slug:** `HOTSPOTSYSTEM`
- **Version:** 20260211_00

## Tools

### List Customers

**Slug:** `HOTSPOTSYSTEM_CUSTOMERS_LIST`

Lists all customers in the HotspotSystem account with optional filtering. Use this tool to: - Retrieve all customers with their details (name, email, contact info, registration date, etc.) - Paginate through large customer lists using limit and offset parameters - Sort customers by any field in ascending or descending order - Filter response to only include specific fields to reduce payload size Returns metadata with total customer count and an array of customer objects.

### List Customers by Location

**Slug:** `HOTSPOTSYSTEM_CUSTOMERS_LIST_BY_LOCATION`

Lists all customers associated with a specific HotspotSystem location. Use this tool to: - Retrieve customer details (name, email, contact info, registration date) for a specific location - Paginate through large customer lists using limit and offset parameters - Sort customers by any field (prepend '-' for descending order, e.g., '-registered_at') - Filter response to include only specific fields to reduce payload size - Query customers at different locations by location ID Returns metadata with total customer count and an array of customer objects. Note: Empty results (total_count: 0) indicate no customers are registered at the specified location.

### Generate Voucher (v1)

**Slug:** `HOTSPOTSYSTEM_GENERATE_VOUCHER_V1`

Generates an access voucher code on-demand for a specific location. This action creates a single-use voucher that can be used for hotspot access. The voucher is generated against available voucher credits in the specified location. Use this when you need to provide immediate access codes to users. Note: Requires an active location with available voucher credits (use the List Locations action first to get valid location_id values).

### List Locations

**Slug:** `HOTSPOTSYSTEM_LOCATIONS_LIST`

Tool to list the resource owner's locations. Use when you need to retrieve locations with optional filtering, sorting, or pagination.

### Misc Ping

**Slug:** `HOTSPOTSYSTEM_MISC_PING`

Tool to perform health check against the HotspotSystem API. Use when verifying connectivity and availability.

### List Subscribers

**Slug:** `HOTSPOTSYSTEM_SUBSCRIBERS_LIST`

List newsletter subscribers across all locations with optional filtering, sorting, and pagination. Returns subscriber information including contact details (name, email, phone, address) and social network data (Facebook, Google, etc.). Supports field selection to retrieve only needed properties, sorting by any field (ascending or descending), and pagination with limit/offset for large result sets. Use this tool when you need to: - Retrieve all subscribers for the account - Filter subscribers by specific fields - Sort subscribers by registration date, name, email, etc. - Paginate through large subscriber lists

### List Subscribers by Location

**Slug:** `HOTSPOTSYSTEM_SUBSCRIBERS_LIST_BY_LOCATION`

Tool to list subscribers by location. Use when you need to retrieve subscribers for a specific location with optional field selection, sorting, and pagination.

### List MAC Transactions

**Slug:** `HOTSPOTSYSTEM_TRANSACTIONS_LIST_MAC`

Tool to list MAC-based transactions. Use when you need to retrieve MAC transaction records with optional pagination and sorting.

### List MAC Transactions by Location

**Slug:** `HOTSPOTSYSTEM_TRANSACTIONS_LIST_MAC_BY_LOCATION`

Lists MAC address authentication transactions for a specific location. MAC (Media Access Control) transactions track network access granted based on device MAC addresses. Use this action when you need to: - View MAC-based authentication history for a specific location - Monitor which devices accessed the network via MAC authentication - Retrieve transaction records with customer data and custom fields - Filter and paginate MAC transaction records for reporting For transactions across all locations, use the global MAC transactions endpoint instead.

### List Paid Transactions by Location

**Slug:** `HOTSPOTSYSTEM_TRANSACTIONS_LIST_PAID_BY_LOCATION`

Tool to list paid transactions by location. Use when you need to retrieve paid transaction records for a specific location with optional pagination and sorting.

### List Social Transactions

**Slug:** `HOTSPOTSYSTEM_TRANSACTIONS_LIST_SOCIAL`

Tool to list social transactions. Use when you need to retrieve social transaction records with optional pagination and sorting.

### List Social Transactions by Location

**Slug:** `HOTSPOTSYSTEM_TRANSACTIONS_LIST_SOCIAL_BY_LOCATION`

Tool to list social transactions by location. Use when you need to retrieve social transaction records for a specific location with optional pagination and sorting.

### List Voucher Transactions

**Slug:** `HOTSPOTSYSTEM_TRANSACTIONS_LIST_VOUCHER`

Tool to list voucher transactions globally across all locations.

### List Voucher Transactions by Location

**Slug:** `HOTSPOTSYSTEM_TRANSACTIONS_LIST_VOUCHER_BY_LOCATION`

Tool to list voucher transactions by location. Use when you need to retrieve voucher transaction records for a specific location with optional pagination and sorting.

### List Vouchers

**Slug:** `HOTSPOTSYSTEM_VOUCHERS_LIST`

Tool to list the resource owner's vouchers across all locations. Use when you need to retrieve vouchers with optional filtering, sorting, or pagination.

### Vouchers List by Location

**Slug:** `HOTSPOTSYSTEM_VOUCHERS_LIST_BY_LOCATION`

Retrieves all vouchers associated with a specific location in the HotspotSystem. Use this action to: - List all vouchers available at a particular location - Filter voucher results by specific fields - Sort vouchers by any field (e.g., validity, price) - Implement pagination for large voucher lists Each voucher includes details such as serial number, access code, usage limits (traffic/download/upload), validity period, and pricing information.
