Skip to main content

Automated Top-Ups

Automated top-ups buy more lookups for your API Key when its balance runs low. Your API Key needs a pre-purchased balance to work, so a top-up plan keeps it working without manual purchases.

Enable automated top-ups​

  1. Open the Billing tab in the left sidebar of your dashboard. Add and save your payment details.
  2. At the bottom of the billing page, add the plan and select the payment method from the drop-down.
  3. Click Enable to confirm the automated top-up.

Enable Automated Top-Ups screenshot

How automated top-ups work​

Once you leave your payment information with us, we top up your API Key when its balance runs low and keep you notified.

  • When we bill. We start a top-up when your balance falls to 10% of your plan volume. On a plan volume of 2,000, we attempt to bill you when your balance reaches 200 lookups.
  • How often. An automated top-up may take place at most once per day.
  • Who we notify. We send a notification each time an automated top-up attempt takes place. We contact only the email addresses on your API Key notification list.
  • Invoices. You can enable automated invoice forwarding from your account page.

Balance expiry​

For data licensing reasons, each lookup batch expires 12 months from first use. Purchasing Lookups explains how expiry works.

When your balance is within 6 weeks of expiring, we notify you and attempt a pre-emptive automated top-up. This surfaces any payment issues before your API Key balance falls to 0.

Which plan should you choose?​

We offer bulk tiers for automated top-ups. See our pricing options for costs.

Each batch lasts 12 months from first use, so we recommend buying 6 to 9 months of lookups in advance. Our lookup guide explains which searches affect your lookup balance.

Related guides​

Contact us if you need more information or support.