API Test Mode
API Test Mode can be enabled or disabled in your API settings. While test mode is on:
- Any order placed via Zapier or the API is automatically cancelled, so nothing is printed or mailed.
- A Radius Search bought via the API or Zapier is limited to 5 records per purchase.
This lets you test your integration without placing real orders or buying a full list of leads.
To access it, click the gear icon at the top right of your dashboard and select API Access.
From there, you can toggle API Test Mode on or off.
Radius Search purchases in test mode
Buying leads is not an order, so it is not something test mode can cancel - a Radius Search charges your account for every record it returns, exactly as it does outside test mode. The 5-record limit is what keeps an integration you are still wiring up from spending real money on a list you only meant to test with.
Send a record_count of 5 or fewer while test mode is on. A larger request is refused with HTTP 422 and a validation error on record_count:
Test mode is enabled on this account, so a radius search bought via API or Zapier is limited to 5 records per purchase. Nothing was purchased and the account was not charged. Send record_count of 5 or fewer, or turn test mode off in the dashboard under API Settings to buy a full list.
The refusal happens before any leads are claimed, so nothing is purchased, your account is not charged, and the attempt does not use up the account's 24-hour duplicate purchase window - you can send a corrected request immediately.
The 5-record limit applies to API and Zapier purchases only. Buying a Radius Search from the dashboard keeps the full 2,500-record maximum whether test mode is on or off.
To buy a full list through the API or Zapier, turn test mode off under API Settings first.