Skip to main content

Automated Top-Ups

An automated top-up plan buys credits for an API key when its balance runs low, so the key keeps working without you buying credits by hand.

Each key has its own plan and its own balance. A plan on one key won't top up another key.

Set up automated top-ups​

  1. Click Billing in the left-hand menu of the dashboard.
  2. Under Add Payment Method, enter your card details and click Save Card.
  3. In the Automated Top-Up Plans table, find the key you want to top up and click Enable. Choose a plan, click Enable Automated Top-Up, then click OK to confirm. On a smaller screen, you may need to scroll sideways within the table to see the Enable button.

How automated top-ups work​

  • When we bill: we top up a key when its balance falls to 10% of its plan volume. On a plan of 2,000 credits, we top up when the balance reaches 200.
  • How often: a key is topped up at most once a day.
  • Who we notify: we send an email every time we attempt a top-up, to the addresses on that key's notification list.
  • Invoices: to have invoices emailed to you, turn on PDF Invoice Forwarding at the bottom of the Billing page.

When credits expire​

Each purchase of credits expires 12 months after you first use it. Purchasing Lookups explains how expiry works.

If a key's credits are within 6 weeks of expiring, we email you and attempt an early top-up. This catches any payment problem before the key's balance reaches 0.

Which plan should you choose?​

Larger plans cost less per credit. See our pricing for each plan.

Credits last 12 months from first use, so we recommend a plan that covers 6 to 9 months of lookups. Our lookup guide explains how credits are counted.

Contact us if you need help.