Invoices and billing

Mapbox provides Pay-as-you-go customers an invoice for all costs accrued each month. Your Invoices page contains your monthly invoices and billing history. To access the Invoices page, log into your account and navigate to

Enterprise customers are invoiced through the Mapbox Finance team. Please contact us with questions about your Enterprise invoicing schedule.

What to expect

Every month, a new invoice is generated. Invoices are generated even if you have not incurred charges for that billing period. You may have multiple pages of invoices. Click on the individual invoices to open them.

Billing period

Your monthly billing period:

  • is one month long
  • begins on the day you create your Mapbox account
  • can change the day you change plans or reactivate after an account deactivation.

Invoices will be automatically posted to your Invoices page and charged to the registered credit card on their due dates. You can find your monthly billing period on your Invoices page. The date on your upcoming invoice marks the day your monthly billing period renews.

Using only what's included in the free tier

On the Pay-as-you-go plan, if you have not exceeded the number of requests, elements, users, or sessions included in your plan, you will see an invoice for $0 on your Invoices page. The number of requests, elements, users, or sessions included in the free tier varies by Mapbox product. You can see units included for each product on the Pricing page.

Exceeding what's included in the free tier

If you exceed the number of requests, elements, users, or sessions included in the free tier, additional units are automatically served at the rates described on our pricing page. In this case, you will receive an invoice with a line item for each product you exceeded.

If you have a valid payment method in your account settings, we will automatically charge the credit card on file at the beginning of your billing period for the products used during your previous billing period. We send you a notification via email each time we charge the credit card you have on file.

If you exceed the requests included in the free tier and there is no valid payment method in your account settings, you will receive an email requesting you update your credit card information or add a credit card to your account. You have a 10-day grace period to update or add a valid credit card before your account, maps, and any applications using your access tokens will be deactivated. Your account will stay locked until you add a valid payment method. Please contact our support team with questions.

Structure of invoices

Each monthly invoice includes three kinds of information:

  • Account information including the email address associated with your account and any additional information you have added to your invoices in the past.
  • Invoice information including the status, date issued, billing period, and an invoice ID.
  • Usage information including line item charges for each service for which your usage exceeded what is included in the free tier and any applicable volume-based discounts.

Details of charges

If you have any service overage charges, you will see a line item under Details of charges. See an example line item charge below.

Optimization API:
cost and details

The product identifies the product you are using. The quantity for each line item on your invoice will reflect amount of the usage you accrued throughout the billing period. The unit describes the billing units associated with the quantity used. The cost will show the total amount in USD for that product, and you can click to see details about how that total was calculated with any applicable discount tiers.

Quantities of billable units

The line items you see listed on your invoice may not have the same name as the Mapbox products you are using to build your applications. For example, if you are using Mapbox GL JS to build a web application, you may see line items for map loads, Vector Tiles API requests, or Raster Tiles API requests.

To learn more about how your applications translate to particular line items, see the Pricing by products guide.

Calculating costs

The price per billable unit depends on the total usage you've accrued for that product. You can see a breakdown of the exact number of billable units at each price by clicking the icon in your invoice.

For more information on what's included in the free tier and costs associated with overages visit our Pricing page.

Invoice management

Pay-as-you-go customers can view and print your invoices from your Billing page. Enterprise customers are invoiced through the Mapbox Finance team.

Add custom information to an invoice

You can provide optional contact information to display on your statements.

  1. Log in and navigate to your invoices.
  2. Open any invoice that you wish to update.
  3. Click the Add additional info link at the top of the page under your email address.
  4. In the text field, enter your organization name, address, VAT number, and/or any additional information you'd like included on the invoice. Click Update additional info.
  5. Your additional information will now appear on your statements.

Paying a closed invoice

If you experienced an account deactivation for failed payments on an invoice, the invoice will be marked as Closed on your account dashboard. Contact support to help pay closed invoices.


Prepaid account credit cannot be used to pay Closed invoices.

Coupons on invoices

You can view your coupon reflected as a discount on any of your invoices. To view the coupon code on your account settings, navigate to your account billing settings.

Downloading or printing invoices

Log in to your account, navigate to, open each invoice individually and use the print button to Save to PDF.


If we have issued you a refund, the funds will be returned to your original payment method 5-10 business days after the refund has been processed.

Payment information

Available payment methods

You can pay for your Mapbox account with the following credit, debit, prepaid, and gift cards: Visa, MasterCard, American Express, JCB, Discover, and Diners Club. Mapbox Enterprise plans are invoiced through our Finance team.

If you do not have access to one of these cards, consider using a prepaid card instead. Prepaid cards are available from several vendors, including:

Add or update payment information

You can add your payment information by visiting your Billing page and clicking the Add payment method button.

If you need to update your payment method, you can do so from your Billing page. Click Edit and enter your new credit card information.

Credit card decline

Unfortunately, banks don't offer us detailed information when a credit card is declined. Check to make sure your credit card is valid and up to date. If the card information seems correct, contact your bank, inquire for more information, and ask for future charges to be accepted. If payments are still being declined after contacting your bank, you may need to try uploading a different credit card for the payment.

Prepaid credit

As long as you have a valid payment method on file, you can add prepaid credit to your account at any time. Account credit will be applied to future invoices on a monthly basis. Prepaid credit cannot be used to pay past or Closed invoices. We won't charge your primary payment method until you run out of credit.

  1. Navigate to your Billing page.
  2. Make sure you have a valid credit card on file.
  3. Click the Add credit button.
  4. Enter the amount of credit you want to buy.
  5. Your credit card will be charged immediately.
  6. After you buy credit, a record will be available on your Upcoming invoice.

Low credit notifications

If you have added prepaid credit to your account with a credit card payment or through an Annual Purchase Agreement (APA), your account will receive an email notification when the credit balance is low. The email will be delivered with the subject [Mapbox Billing] Low credit notice to the registered email address on the account when the credit balance is less than two invoices. The low credit notification includes the ID of the account, the amount of credit remaining, and a link to your billing settings where you can add more credit.

Coupons and discounts

If you've received a coupon code, you can use it when you sign up or upgrade your account on your Billing page after you've filled in your payment details. If you have any issues, contact our support team for help.

Non-profit and educational discounts

We do not offer a specific plan for non-profit or student users. Instead, our Community team provides tailored support for non-profits, educational institutions, and positive-impact organizations. If you need a discount for your positive-impact project please contact the community team.

Email receipts

We will email you with invoice notifications at the email address connected with your Mapbox account. It is not possible to add a separate billing email address to your account. We recommend setting up a forwarding rule in your email client that automatically forwards emails titled "Mapbox payment receipt" to the relevant stakeholders. Let us know if this feature is important to you!

Spending alerts

You'll receive an email with the subject "[Mapbox Billing] Free Tier Exceeded" when your account exceeds the free allotment of services, but we don't yet offer configurable email or SMS notifications. Let us know if this is a feature you'd like to see!

Spending cap

We do not yet support a spending cap. For now, you can create predictable monthly spending by adding a set amount of prepaid credit and by monitoring your account statistics and your invoices closely. Once your invoice reaches an amount you'd like to pay for that billing period, you can rotate your access tokens (making your older tokens invalid).

When you rotate your access tokens, your production maps will become deactivated and your account will have no more traffic. When you're ready to activate your account again, you can rotate your new tokens into your implementation and your maps will be re-activated.


If you see inconsistencies between usage on your Statistics page and charges on your monthly Invoice, see Analyze statistics and invoices. If the inconsistencies you are seeing are not explained in that guide, please contact support.

Was this page helpful?