Skip to main content
Start with a free balance check and Contact Count. These requests confirm access and help you size an audience before choosing how much to retrieve.

Prerequisites

  • A RevenueBase account.
  • An API key from your dashboard.
Set your key as an environment variable:
1

Check your credit balance

This request costs 0 credits and does not reserve a hold.
Response captured from the local test API on October 13, 2026. Results can change.
Read credits as your reported credit balance. It is separate from the free View sample allowance. A 401 means you should check the key and header; see authentication.
2

Count an audience for free

This request counts VPs located in the United States. Count costs 0 credits, including when your filter uses SmartSearch.
Response captured from the local test API on October 13, 2026. Results can change.
total is the matching contact-row count. Read the exact flags: false means that figure is an estimate. Use mode: "exact" when you need precise company and availability counts.
3

Inspect before retrieving

Reuse the filter in View for a free masked sample. Adjust it until the sample looks right.Then Estimate with a positive maxRows cap and explicit reveal choices before Start Export. The estimate is free; a PAYG export reserves credits before running.

Choose your next step