> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pixalate.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pixalate.com/_mcp/server.

# Quota and usage

> How MRT and Enrichment API quota works. Input items and output items, region and device combinations, the shared monthly quota, and the Quota Usage page.

Your Media Ratings Terminal (MRT) subscription comes with a monthly quota. The same counting rules apply whether you look up apps and domains in the MRT, import a CSV file in Discovery or call the [Enrichment API](/apis/enrichment-api). This page explains how usage is counted. Your contract sets the size of your quota.

## What the quota covers

Your monthly quota can be allocated across the three supply types the MRT supports:

* websites
* mobile apps
* CTV apps

The quota is **shared**: every debit comes out of your account's monthly quota. No user on your account has a personal share of it.

Your subscription may also include an overage allowance, so you can keep working if you use up your monthly quota before it refreshes. Overage use is charged separately. Ask your Pixalate account manager about your allocation, any overage allowance and how it's billed.

## How usage is counted

Usage is counted in **input items** and **output items**.

| Term        | What it means                                                                                                                                                                                        | Quota used                                                        |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Input item  | Each app or domain you submit for processing, whether you submit it in the MRT, through Import CSV or in an API request.                                                                             | One unit when you submit it.                                      |
| Output item | Each result returned or made available for an input item: an app, a domain or any other result. This includes items shown in the MRT, items in an API response, and items in a CSV or JSON download. | One more unit for each result delivered or made available to you. |

So a single input item can use several units:

* one for the input item itself, and
* one for each output item returned for it.

An API response, CSV download or JSON download can contain many output items. Each one is counted separately.

> **Note**
>
> An input item uses its unit when you submit it, even if no results come back for it. Output units are used only for results that are returned.

## Control usage with region and device

![Import filter dialog](/_fern-img/f03f0d6a798238a72f08f63f9f7047a7584349bc7f4d82721b4132ac63ddfd13.webp)

Each region and device combination returned for an input item is a separate output item. Asking for fewer combinations returns fewer results and uses less quota.

**In the MRT:** before you import a CSV file in [Discovery](/mrt/discovery), choose the **Region** and **Device** combinations you want. Setting both to **GLOBAL** returns one combination (one output item per store), which meets most needs.

**In the Enrichment API:** set the `region` and `device` parameters. Without them, a lookup returns a result for every region and device combination.

```bash
curl "https://api.pixalate.com/api/v2/mrt/apps/com.example.mobileapp?region=GLOBAL&device=GLOBAL" \
  -H "x-api-key: $PIXALATE_API_KEY"
```

The allowed values differ by supply type. See [Filter by region and device](/apis/enrichment-api#filter-by-region-and-device).

## Check your usage in the MRT

The **Quota Usage** page shows how much quota you have left and a log of your usage.

#### Open the account menu

Sign in to the MRT and hover over your name in the upper-right corner of any page.

#### Select Quota Usage

Select **Quota Usage** from the menu.

Check it before a large import so you don't run into overage.

## Check your usage through the API

Call the base path for a supply type, with no app or domain, to get your quota status:

```bash
curl "https://api.pixalate.com/api/v2/mrt/apps?pretty=true" \
  -H "x-api-key: $PIXALATE_API_KEY"
```

Use `/mrt/ctv` and `/mrt/domains` for the other supply types. The response includes a `quota` object with `available`, `used`, `limit` and `expiry` (when the quota next refreshes). For the full field list, and the equivalent calls for the Analytics Reports API and Fraud API, see [Check your quota](/apis/quotas-and-errors#check-your-quota).

Keep your API key in an environment variable or secret store. Don't print it to the terminal or to logs. See [Authentication and API keys](/apis/authentication).

## Related

#### [Quotas, limits and errors](/apis/quotas-and-errors)

Quota for every Pixalate API, and what each HTTP status code means.

#### [Enrichment API](/apis/enrichment-api)

Look up apps and domains programmatically.

#### [Check many apps or domains at once](/mrt/bulk-lookups)

Import a list of apps or domains into the MRT.

#### [MRT FAQ](/mrt/faq)

Common questions about the Media Ratings Terminal.

For questions about your quota or contract, contact your Pixalate account manager. For anything else, email [support@pixalate.com](mailto:support@pixalate.com).