> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Check application usage (API calls)

> How to check the API call statistics for your application and monitor metered services.

Metered API calls come from applications that are not part of the SuperOffice standard products.

**Count** is the number of API calls. **Record count** is how many database records these API calls asked for. One database record could be asking for a company (with all additional entities, such as address, phones, URLs, and emails), and it may be one contact person with all additional entities linked to it. Asking for a list will count each list item as one database record.

## At a glance

The **app page** shows application usage for one specific application.

1. In the Developer Portal, go to your app page.

   To see the list of all apps:

   * Select **Apps** from the top menu to see all apps across every partner you have access to, or
   * Go to the **Applications** section of your partner page to see that partner's apps.

2) Select **API metrics**, then select **API Usage** tab.

3) Select a time range interval (days, weeks, or months).

4) Click through the environment specific buttons.

![API usage overview in SuperOffice developer portal -screenshot][img1]

### Legend

| Type of usage  | Description                                                                                               |
| -------------- | --------------------------------------------------------------------------------------------------------- |
| MeteredApps    | The number of API calls this app does for custom and standard apps.                                       |
| Customizations | The number of API calls from CRMScripts or screens that are custom (non-standard Service functionality)   |
| IncludedApps   | The number of API calls from SuperOffice's own apps with **Exclude from invoice**. Standard functionality |

<Tip>
  Click on the individual items in the legend to filter what is shown in the graph.
</Tip>

![API usage filtering -screenshot][img4]

## Filter by customer

* To see the impact of your app on one specific customer (tenant), select a customer from the drop-down list.

  <Note>
    The list contains only the [customers that have authorized the app][1] for a specific environment. For example, a SOD tenant appears only in the SOD environment. If you don't see a customer you think should be in the list, check that you have selected the correct environment.
  </Note>

* To clear the filter, click the red cross.

## Improve app performance

Leverage our [best practices for online app development][2] to both boost your application's performance and reduce its API usage. Both [caching][3] and [search][4] have a huge impact.

Additional columns from SuperOffice version 10.5.1

| Column       | Description                                                                                                                                                                      |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| NsApiSlow    | True if API call is higher than treshold. You will find tresholds for methods in our documentation.                                                                              |
| providerName | The [archive provider][5] used in the request (e.g., contact, sale, project). Knowing the provider helps identify the data source and optimize queries accordingly.              |
| columns      | Specifies which columns are requested from the archive provider. Best practice: Limit the number of columns to only those needed to reduce payload size and improve performance. |
| restriction  | Filters applied to the search query. Tip: Use indexed fields and avoid complex expressions to enhance query speed.                                                               |
| pageSize     | Number of items returned per page. Default is 1000.                                                                                                                              |
| page         | The page number of the result set. Useful for paginated queries.                                                                                                                 |
| sortOrder    | Sorting applied to the result set, if any. Note: Sorting on indexed fields is faster. Avoid sorting on calculated or non-indexed fields.                                         |
| itemCount    | Number of similar API calls made in the past 24 hours. Can be used to identify high-traffic endpoints and optimize caching or batching strategies.                               |
| url          | The full URL of the API request. Useful for debugging and reproducing queries.                                                                                                   |

[2]: ../../best-practices/index

[3]: ../../best-practices/index#caching

[4]: ../../best-practices/index#searching

[5]: ../../../api/netserver/archive-providers/reference/index

The default time period when you look at API calls is **Months**, but you can change the resolution on the horizontal axis to **Weeks** or **Days**.

![API usage per week -screenshot][img2]

![API usage per day -screenshot][img3]

During development, following the statistics in SOD day-by-day can provide valuable insight into the impact of your improvements.

[1]: ../tenants/authorization

[img1]: /media/loc/en/developer-portal/usage.png

[img2]: /media/loc/en/developer-portal/usage-days.png

[img3]: /media/loc/en/developer-portal/usage-weeks.png

[img4]: /media/loc/en/developer-portal/usage-filter.png


## Related topics

- [Check application API performance](/en/developer-portal/analytics/metrics-performance.md)
- [Check exceptions from your app's API calls](/en/developer-portal/analytics/failures.md)
- [Collect Web Usage](/en/api/reference/restful/agent/diagnostics_agent/collect-web-usage.md)
- [Collect Win Usage](/en/api/reference/restful/agent/diagnostics_agent/collect-win-usage.md)
- [Check tenant status](/en/developer-portal/best-practices/tenant-status/check-status.md)
- [Webhook_usage table](/en/database/tables/webhook-usage.md)