> ## Documentation Index
> Fetch the complete documentation index at: https://docs.royaltyport.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Usage
> Track AI and external-service cost and consumption across your organization
## Overview
The **Usage** page gives your organization a single view of what you are spending on Royaltyport's AI features and how much your projects are consuming from connected external services. It breaks costs down by product and feature, charts spend over time, and lists request volumes for each external provider.
Usage is available to organization **Admins**. Collaborators and Viewers cannot access organization settings.
***
## Accessing Usage
Navigate to your organization from the Dashboard, then click **Settings** in the navigation.
Click the **Usage** tab in the settings sidebar.
***
## Choosing a time period
Two controls at the top of the page determine what the dashboard shows.
### Date range
Use the range selector to pick the window you want to see. All figures — the summary tiles, the chart, and the breakdown sections — update to the selected period.
| Preset | Window |
| -------------- | ----------------------------------- |
| Current month | The 1st of this month through today |
| Last month | The whole previous calendar month |
| Last 30 days | The trailing 30 days |
| Last 90 days | The trailing 90 days |
| Last 6 months | The last 6 calendar months |
| Last 12 months | The last 12 calendar months |
### Granularity
Switch the chart between **Daily**, **Weekly**, and **Monthly** buckets to zoom in on individual days or step back for a longer-term trend. Granularity affects only how the chart is grouped — the totals stay the same.
***
## Summary tiles
Four tiles across the top summarise cost and token consumption for the selected period:
| Tile | What it shows |
| -------------- | ------------------------------------------------------------------------ |
| **Total cost** | Combined cost of all AI usage in the period, with total tokens processed |
| **Input** | Cost and token count for prompt input sent to the AI |
| **Output** | Cost and token count for AI-generated output |
| **Cached** | Cost and token count served from cached content |
All costs are shown in USD. Amounts are formatted using your organization's number and currency preferences.
***
## Cost over time
Below the tiles, a stacked bar chart plots cost across the selected period, with each product shown in its own colour. This makes it easy to see which products drive your spend and how usage rises or falls over time. Use the granularity toggle to change the bar interval.
If there is no AI usage in the selected window, the chart is replaced with a short "No cost in this period" message.
***
## Royaltyport AI
The **Royaltyport AI** section lists your AI spend grouped by product — for example Contracts, Statements, Catalog, CRM, and the AI assistant. Each product row can be expanded into the individual features that contributed to it.
For every product and feature you'll see:
| Column | Description |
| ----------- | ----------------------------------------------------------- |
| **Feature** | The product or feature line item |
| **Trend** | A small sparkline showing day-by-day cost across the period |
| **Tokens** | Total tokens processed |
| **Cost** | Cost in USD |
Rows are ordered from highest to lowest cost, so your biggest line items appear first.
***
## Royaltyport Services
The **Royaltyport Services** section covers the external data services your projects call — such as **Spotify**, **Chartmetric**, **MLC**, and **Discogs** — used for asset matching and enrichment. These are measured by request volume rather than tokens.
For each service group and provider you'll see:
| Column | Description |
| ------------ | ----------------------------------------------- |
| **Provider** | The external service |
| **Trend** | A sparkline of request volume across the period |
| **Requests** | Total number of requests made |
If a provider returned errors or was rate-limited during the period, a short summary appears next to its name. Hover over it to see the exact counts.
A high number of errors or rate-limited responses for a provider can explain missing matches or slower enrichment. Use this as a first place to check when external data looks incomplete.
***
## When there's no data
If your organization hasn't recorded any AI or external-service usage yet, the page shows a "No usage data available" message instead of the dashboard. Figures appear as soon as your projects begin processing contracts, statements, or catalog data.
***
## Related Documentation
Understand which roles can view organization settings.
Configure your organization's basic information.
See how external services are used to match statement assets.
Learn about the AI assistant that contributes to usage.