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

# Billing and usage

> See your plan, your record export allowance and the limits on activations and exports

Billing & Usage shows your plan, how much of your record export allowance you've used and the limits on how much you can activate and export. To open it, select your name at the bottom of the sidebar, then **Settings → Organization → Billing & Usage**, or go straight to [app.minerva.io/settings/billing](https://app.minerva.io/settings/billing).

Minerva measures two separate things, and an activation has to fit both:

* **Record export allowance** is the number of unique people your plan lets you export in a contract term.
* **Operational limits** cap how many people you can include in a single activation and in a month.

## Plans

| Plan | How it works |
| - | - |
| Trial | 14 days, no payment method required. Includes record exports of up to 100 unique people, with no paid overage. When the trial ends, access pauses until a paid plan starts. Your data is kept. |
| Growth Plan | A 12-month commitment, paid monthly or yearly. Includes a record export allowance, more records released each month and an overage rate for records beyond your allowance. See [current plans and pricing](https://www.minerva.io/pricing). |
| Enterprise agreement | Your allowance, release schedule and overage rate are set in your agreement. |

## What uses your allowance

| Action | Uses allowance |
| - | - |
| Searching, building segments, scoring, Bulk Enrich and working with Minerva Agent | No |
| Activations to Paid ads and Direct mail destinations | No |
| CSV files in an ad platform, direct mail or hashed email format | No |
| Downloading a completed CSV again | No |
| CSV files in the All columns, HubSpot columns or Salesforce columns format | Yes |
| Activations to Marketing and Sales destinations, such as Klaviyo, HubSpot and Salesforce | Yes |
| Data API and MCP requests that return person records | Yes |

**Paid ads**, **Direct mail**, **Marketing** and **Sales** are the groups you choose from when you [activate a segment](https://docs.minerva.io/platform/activation/overview.md).

## How the allowance works

* **It counts unique people.** Each person counts once per contract term, however many times or ways you export them. On a Growth Plan, the contract term is one year.
* **It's released over the term.** A Growth Plan adds more records each month. Records you don't use stay available for the rest of the term and expire at renewal.
* **It includes exports in progress.** A record export sets aside allowance as soon as it starts and returns it if the export fails. Because of that, the allowance meter can be ahead of the **Record usage** history, which only counts exports that have finished.

## Overage and your monthly limit

If your plan includes overage, records beyond your allowance are billed at your plan's overage rate, up to your **Monthly limit**.

* Minerva warns you before overage begins and as you approach your monthly limit.
* At the limit, record exports pause. This includes activations to **Marketing** and **Sales** destinations, general CSV files, and Data API and MCP responses that return person records. Search, Bulk Enrich, Minerva Agent and activations to **Paid ads** and **Direct mail** destinations remain available.
* Raising the limit or upgrading your plan resumes record exports.
* The limit is a target, so the final amount can slightly exceed it.

A Trial has no paid overage. When its 100 records are used, upgrade to a paid plan to export more.

## Operational limits

Operational limits are separate from your allowance:

* They apply to every activation, including ones that don't use your allowance.
* The monthly operational limit resets each calendar month, counted in UTC. Your allowance follows your contract term instead.

Your limits are shown on **Billing & Usage**. If an activation is blocked, check which limit it hit. Having allowance left doesn't override an operational limit.

## Who can change billing

Changing billing details, the plan or the **Monthly limit** needs the Admin role. If you don't see those controls, ask an Admin in your organization.

If your plan is managed by an agency, your record exports count toward the agency's shared usage and limits. Contact your agency to change anything.

## Troubleshooting

| Problem | What it means |
| - | - |
| Your included allowance is used up | You see **All included records have been used. Additional record exports now count toward this month's overage.** Record exports continue as overage, up to your monthly limit. |
| Record exports are paused | You see **Record exports are paused until capacity becomes available. Campaign activations to supported ad and direct mail platforms remain available.** You've reached your monthly limit. Raise the limit or upgrade your plan. If you can't change billing, ask an Admin in your organization. |
| Usage shows as unavailable | The page couldn't load your usage. It doesn't mean your usage is zero. |
| An activation is blocked but you have allowance left | The activation hit an operational limit. Check your limits on **Billing & Usage**. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.