> For the complete documentation index, see [llms.txt](https://chekin.gitbook.io/chekin-public-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chekin.gitbook.io/chekin-public-api/api-reference/premium-feature-usage.md).

# Premium Feature Usage

### Overview

The Premium Feature Usage API lets you see which premium features are currently enabled on your housings. For each account you manage, you can check per-housing status and get an aggregated summary across the account.

The premium features reported are:

* **Identity Verification**
* **Remote Access**
* **Guidebooks**

Each feature is reported as `ACTIVE` or `INACTIVE` per housing.

### Key Capabilities

* [**List Premium Feature Usage**](/chekin-public-api/api-reference/premium-feature-usage/list-premium-feature-usage.md)\
  Retrieve all of the account's housings, each with the status of every premium feature.
* [**Premium Feature Usage Summary**](/chekin-public-api/api-reference/premium-feature-usage/premium-feature-usage-summary.md)\
  Get aggregated counts (active / inactive) per premium feature for the account.

### How to use

* Authentication is required for all endpoints. This is done via a token received on [Authentication](/chekin-public-api/authentication.md), obtained with the account's own API key.
* Access is **per account**: each call returns data for the authenticated account's own housings only. A partner managing several accounts queries each one using that account's API key.
* These endpoints are read-only (`GET`).

> **Tip:** to be notified in real time when a feature is turned on or off, subscribe to the matching [Webhooks](/chekin-public-api/api-reference/webhooks.md) (`Housing.identity_verification.*`, `Housing.remote_access.*`, `Housing.guidebook.*`).