# Retrieve installs count

```
GET 
https://api.freemius.com/v1/products/{product_id}/installs/count.json
```

#### Auth:Bearer TokenSCOPE: <!-- -->PRODUCT

Product-scoped API tokens allow you to operate on the product itself. This token usually allows read-only access to the product configuration and write access to several operations on subscriptions, customers, payments, and more. For most SaaS or app integrations, this is the token you will need.

1. Go to the [Freemius Developer Dashboard](https://dashboard.freemius.com/).
2. Open the Settings page of the relevant product.
3. Click the API & Keys tab.
4. Copy the API Bearer Authorization Token from the UI.

***

Retrieve the number of installs associated with the product.

### Filtering[​](#filtering "Direct link to Filtering")

You can filter the count by `plan_id` or `is_active`.

## Request[​](#request "Direct link to request")

### Path Parameters

* **product\_id**
  <!-- -->
  integer\<int64>[](#param-property-installations-retrieve-installs-count-param-path-product-id "Direct link to product_id")required

  The ID of the product.

  **Possible values:** `>= 1`

  **Example:<!-- -->&#x20;**`1234`

### Query Parameters

* **plan\_id**
  <!-- -->
  number[](#param-property-installations-retrieve-installs-count-param-query-plan-id "Direct link to plan_id")

  (optional) Return the count of installs that are associated with a non-expired license for the given plan ID.

  **Example:<!-- -->&#x20;**`1`

  **is\_active**
  <!-- -->
  boolean[](#param-property-installations-retrieve-installs-count-param-query-is-active "Direct link to is_active")

  (optional) Return active installs only.

  **Example:<!-- -->&#x20;**`false`

<!-- -->

## Responses[​](#responses "Direct link to Responses")

* 200

The number of installs with the product.

application/json

**Schema**

**count**integer[](#schema-property-installations-retrieve-installs-count-response-schema-count-integer "Direct link to count")

**Possible values:** `>= 0`

**Example:<!-- -->&#x20;**`123`