> ## Documentation Index > Fetch the complete documentation index at: https://support.affinity.co/llms.txt > Use this file to discover all available pages before exploring further. # How to Explore Your API Usage > See your organization's API usage over time, by user, and by app on the Usage page in Settings, including how much traffic comes from Affinity MCP. > [!NOTE] > > **How-to** — task-oriented recipe. **Last Updated:** October 29, 2026 **Object Tags:** API, API Usage, Usage, Manage Apps, MCP, Integrations, Admin ## Overview The **Usage** page in Settings shows how your organization uses the Affinity API. You can see: * Your total API requests this month, against your monthly limit. * Requests over time, by user, and by app. * How much of your traffic comes from Affinity MCP, and how much comes from other tools calling the API directly. Use it to find the users and apps that make the most requests, and to spot a noisy app before you reach your limit. ## Prerequisites **Plan:** Your plan must include API access. **Permissions required:** **View API usage**. Enterprise Admins can grant it to other roles under **Settings → Users and Permissions → Roles**, in the **APIs / Integrations** section. If you don't see **Usage** in Settings, ask an admin for this permission. ## Step 1: Open the Usage page 1. Click **Settings** in the left navigation. 2. Under **Usage**, click **Usage**. If you can also see Billing, this section is called **Usage & Billing**. The page opens with the title **Usage** and the subtitle **Metered Usage Across Your Organization**. ![The Usage page with the date, User, App and Group by filters, the Total Usage and Traffic Source cards, the Usage Over Time chart and the Usage Breakdown table](https://mintcdn.com/support-affinity/mGOui9wOMNi2G9h4/images/admin-apps-apis/how-to-explore-api-usage/settings-usage.png?fit=max\&auto=format\&n=mGOui9wOMNi2G9h4\&q=85\&s=8ef399ae1c8534bed7a4f9f496e662a3) ## Step 2: Check your total for the month The **Total Usage** card shows the **API Requests** your organization has made **This Month**. * If your organization has a monthly limit, the card shows the limit, how much of it you've used (for example, **37% Used**), and how many requests remain (**Remaining**). * If your organization has no monthly limit, the card shows **Unlimited**. This card always covers the current month. The filters on the page don't change it. ## Step 3: Choose what to look at Use the filters at the top of the page. They apply to the **Traffic Source** card, the chart and the table. | Filter | What it does | | - | - | | Date range | The default is **Last 30 days**. Choose **Last 7 days**, **Last 30 days** or **Last 90 days**, or pick your own start and end dates. | | **User** | Show requests from one user. The default is **All**. | | **App** | Show requests from one app, such as an API key or an OAuth app. The default is **All**. | | **Group by** | Show the chart and table by **App** (the default) or by **User**. | The **User** and **App** lists only include users and apps that made requests in the selected date range. ## Step 4: See where your traffic comes from The **Traffic Source** card splits your requests into three sources: | Source | What it means | | - | - | | **MCP** | Requests made through Affinity MCP, for example from Claude or ChatGPT. | | **Direct API** | Requests from any other tool that calls the Affinity API, such as a script or an integration. | | **Unattributed** | Requests whose source isn't known. | The split is an estimate. It's based on the source each request reports about itself. ## Step 5: See usage over time The **Usage Over Time (Top 5)** chart shows daily **API Requests** for the five apps or users with the most requests. Use **Group by** to switch between apps and users. Hover over the chart to see each day's numbers. ## Step 6: Find your busiest apps and users The **Usage Breakdown** table lists every app or user with requests in the selected date range, most requests first. | Column | What it shows | | - | - | | **App** or **User** | The app or user. The column name follows your **Group by** choice. | | **Traffic Source** | Where most of that app's or user's requests came from: **MCP**, **Direct API** or **Unattributed**. | | **API Requests** | The number of requests in the date range. | | **Share** | That app's or user's share of all requests in the table. | | **Last Activity Date** | The last day with requests in the date range. | Some rows have a placeholder name: * **Unnamed app** is an API key that was saved without a name, or requests that aren't linked to an app. To name a key, edit it in **Settings → Manage Apps**. * **Unattributed**, when grouped by user, is requests that aren't linked to a user. If the table shows **No API requests in this range.**, there were no requests that match your filters. Try a longer date range or clear the **User** and **App** filters. ## How this page relates to Manage Apps The **API Usage This Month** card in **Manage Apps** and the **Total Usage** card on the **Usage** page show the same monthly total. Requests from API keys, OAuth apps and Affinity MCP all count toward it. Use **Manage Apps** to create, edit or revoke apps. Use **Usage** to see which of them make the most requests. ## Current limitations * Days are in US Pacific time. * Today's requests aren't in the chart, the table or the **Traffic Source** card yet. They appear the next day. * The **Traffic Source** split is an estimate. * The page shows request counts only. It doesn't show which endpoints an app calls. ## FAQ **Why doesn't the chart match the Total Usage card?** The **Total Usage** card counts the whole current month. The chart, the table and the **Traffic Source** card cover the date range you choose, and they don't include today. **How do I see how much of our usage comes from MCP?** Look at the **Traffic Source** card. To see which people use MCP the most, set **Group by** to **User** and check the **Traffic Source** column. **One app is making a lot of requests. What can I do?** Find the app in the **Usage Breakdown** table, then contact its owner. You can see who owns each app in **Settings → Manage Apps**. If you need to stop it, revoke it there. **Who can see the Usage page?** Anyone with the **View API usage** permission, if your plan includes API access. ## Related articles * [Manage Apps reference](https://support.affinity.co/s/article/Manage-apps-reference.md) * [How to create and manage API keys](https://support.affinity.co/s/article/How-to-create-and-manage-API-keys.md) * [How to create and manage OAuth apps](https://support.affinity.co/s/article/How-to-create-and-manage-OAuth-apps.md) * [How to audit API keys in your instance](https://support.affinity.co/s/article/How-to-audit-API-keys-in-your-instance.md) * [Getting started with Affinity MCP](https://support.affinity.co/s/article/Getting-started-with-Affinity-MCP.md) * [Rate Limits (developer docs)](https://developer.affinity.co/pages/external-api-v2/rate-limits) ## Related topics - [How to Create and Manage OAuth Apps](https://support.affinity.co/s/article/How-to-create-and-manage-OAuth-apps.md) - [Manage Apps Reference](https://support.affinity.co/s/article/Manage-apps-reference.md) - [How to Audit API Keys in Your Instance](https://support.affinity.co/s/article/How-to-audit-API-keys-in-your-instance.md) - [Getting Started With The Affinity API + FAQs](https://support.affinity.co/s/article/Getting-started-with-the-Affinity-API-faqs.md) - [How to Create and Manage API Keys](https://support.affinity.co/s/article/How-to-create-and-manage-API-keys.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.