> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

# Manage Billing for Native Reranking

You can manage payments and billing for Native Reranking through the billing and payments interface in the Atlas UI. Atlas sends billing charges to the Atlas account linked to your cluster. Your billing profile for Atlas is the same as the billing profile for your Native Reranking. To view or edit your billing profile, see [Atlas Billing.](https://www.mongodb.com/docs/atlas/billing.md#std-label-atlas-billing)

## Overview

Native Reranking uses a token-based pricing model where Atlas charges you based on the number of tokens that the `$rerank` stage processes. Atlas charges the `$rerank` stage separately from other Voyage AI operations in your Atlas project.

### Token-Based Pricing

Atlas uses a pay-as-you-go pricing model and charges for usage based on the total number of processed tokens. The following formula calculates the total:

```text
total number of processed tokens = (number of query tokens * numDocsToRerank) + sum(number of tokens across all documents)
```

#### Free Tokens

For the latest models, Atlas includes a one-time allocation of 200 million free tokens at the organization level. The organization shares free tokens across all Atlas projects and clusters within the organization. Free tokens do not refresh. To learn more about rate limits and usage tiers, see [Usage Tiers and Rate Limits.](https://www.mongodb.com/docs/vector-search/query/native-reranking/managing.md#std-label-rerank-rate-limits)

#### Token Usage

Monitor your token usage on the Usage page in the Atlas UI. Usage is constrained by requests per minute (RPM) and tokens per minute (TPM) per cluster. To learn more, see [Usage Tiers and Rate Limits.](https://www.mongodb.com/docs/vector-search/query/native-reranking/managing.md#std-label-rerank-rate-limits)

The Usage page provides several views to monitor and analyze your token usage. Click the Free Usage tab to view remaining free tokens by model for your organization.

In the Usage Activity tab, the Total Usage chart displays the total tokens used across your project over time. You can filter usage data by using the following options:

| Option | Description |
| --- | --- |
| Usage Period | View usage data for a specific time range. |
| Models | Filter by specific Voyage AI models. |

To learn how to monitor token usage on a more granular level, see [Monitor Token Usage.](https://www.mongodb.com/docs/vector-search/query/native-reranking/managing.md#std-label-rerank-monitor-usage)

### Model Pricing

The cost for each model is as follows:

| Model | Price per 1K tokens | Price per 1M tokens | Free Tokens |
| --- | --- | --- | --- |
| `rerank-3` | $0.00005 | $0.05 | 200,000,000 |
| `rerank-3-lite` | $0.00002 | $0.02 | 200,000,000 |
| `rerank-2.5` | $0.00005 | $0.05 | 200,000,000 |
| `rerank-2.5-lite` | $0.00002 | $0.02 | 200,000,000 |
| `rerank-2` | $0.00005 | $0.05 | |
| `rerank-2-lite` | $0.00002 | $0.02 | |

## Manage Billing

### Required Access

- To view billing information, you must have at least [`Organization Billing Viewer`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Billing-Viewer) access.

- To configure billing settings, such as the payment method and billing profile, you must have [`Organization Owner`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Owner) or [`Organization Billing Admin`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Organization-Billing-Admin) access.

### Procedure

To access billing:

1. Log in to [Atlas](https://cloud.mongodb.com).

2. In Atlas, go to the Billing page for your organization.

   If it's not already displayed, select your desired organization from the  Organizations menu in the navigation bar.

   In the sidebar, click Overview under the Billing header.

   The [Billing](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2Foverview) page displays.

### Billing Page Features

The Billing > Overview page includes the following:

- The Pending Invoice, which includes

  Net Month-to-Date Amount, showing the total amount due for your usage so far this month. It also shows the Month-to-Date Usage, including whether usage went up or down compared to this time last month, the usage for This Time Last Month, the Billing Period, and the Invoice Date. Click View Pending Invoice to view details.

- The Last Invoice, which shows the

  Amount Due, Total Usage, Billing Period, and Invoice Date. Click View Invoice to view details.

- The Usage chart, which displays your organization's

  Native Reranking usage over the past one year in the By Service tab. You can hover over the point in the chart to see the usage for that month.

  **Tip:**

  To understand your usage's cost, use the [Cost Explorer](https://www.mongodb.com/docs/atlas/billing.md#std-label-cost-explorer) in the Atlas UI and filter by Native Reranking. MongoDB derives costs from metering data and updates them every 24 hours.

### Payment Method

To pay for Native Reranking, use your configured payment method. MongoDB accepts the following payment methods through the Atlas console:

- Credit card

- [PayPal](https://www.paypal.com/us/home)

To set your payment method for Native Reranking in Atlas, see [Atlas Payment Methods.](https://www.mongodb.com/docs/atlas/billing.md#std-label-atlas-billing-methods)

Through [MongoDB Sales](https://www.mongodb.com/contact/atlas?tck=docs), you can also pay using:

- A currency other than USD

- A method other than a credit card or PayPal

**Important:**

To confirm your credit card information, Atlas charges $1.00 when you first connect a credit card to your account. After Atlas confirms your information, it refunds the $1.00 charge. If you encounter any issues with connecting a credit card to your account, contact your card provider or banking institution. Verify whether they declined the initial charge, which would prevent Atlas from confirming your information.

## Manage Invoices

### View Invoices

To view the most recent and pending charges for your `$rerank` stage usage in an organization:

1. In Atlas, go to the Billing page for your organization.

   If it's not already displayed, select your desired organization from the  Organizations menu in the navigation bar.

   In the sidebar, click Invoices under the Billing header.

   The [Invoices](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%23%2Forg%2F%3Corganization%3E%2Fbilling%2FpaymentHistory) page displays.

2. Click the Invoice Date that you want to view.

**Tip:**

You can also access billing information directly from the Usage page by clicking the View Invoice button.

### Invoice Page Features

For each of your invoices, including your current invoice, you can:

- View the payment amount due, the total cost of your usage for the billing period, and your billing information.

- Export the invoice details to a PDF or CSV file.

- Explore invoice cost visualization charts that show total usage costs by service, such as Native Reranking.

- Review usage summaries by project and by service, such as Native Reranking.

- Examine payment and usage details that explain usage and paid and pending charges for Native Reranking.

Your invoice shows usage categorized by reranker model, such as `rerank-3`, `rerank-3-lite`, `rerank-2.5`, and `rerank-2.5-lite`, including the number of tokens processed and the cost per model.

To learn more about invoice features, see [Invoices.](https://www.mongodb.com/docs/atlas/billing.md#std-label-examine-invoices)

## Review the Costs

You can use the Cost Explorer to understand your Native Reranking costs. The Billing Cost Explorer helps you understand your organization's billing data on a month-to-month basis. You can view monthly billing data in chart and table form.

Costs are based on the total number of tokens that the `$rerank` stage processes. To monitor your token usage, see [Monitor Token Usage.](https://www.mongodb.com/docs/vector-search/query/native-reranking/managing.md#std-label-rerank-monitor-usage)

### Procedure

1. Log in to [Atlas](https://cloud.mongodb.com).

2. Go to the Billing page for your organization.

   If it's not already displayed, select your desired organization from the  Organizations menu in the navigation bar.

   In the sidebar, click Cost Explorer under the Billing header.

   The cost explorer provides a visual representation of your billing data, including Native Reranking costs. To learn more, see [Billing Cost Explorer.](https://www.mongodb.com/docs/atlas/billing.md#std-label-cost-explorer)

3. Filter by Native Reranking.

   To filter by Native Reranking, select the Native Reranking option from the Service dropdown menu.
