---
title: "Radius Search Count"
method: POST
path: "/mailing-lists-utils/count-radius-search"
tags: ["Mailing Lists"]
---

# Radius Search Count

`POST /mailing-lists-utils/count-radius-search`

## Request

- Base URL: `https://api.thanks.io/api/v2`
- URL: `https://api.thanks.io/api/v2/mailing-lists-utils/count-radius-search`
- Auth: HTTP bearer

This call reports how many records a radius search would find, without buying them. Nothing is charged, no mailing list is created, and the call can be repeated freely, so use it to preview a search before purchasing it with the Radius Search endpoint. It accepts the same search parameters with the same defaults, so sending the same payload to both counts exactly what would be bought. Because counting is free, record_count may go up to 10,000 and the API/Zapier Test Mode purchase limit does not apply.

## Request body

- object
  - `address` string, required: Street address to use for center of nearest neighbor search.
  - `postal_code` string, required: Postal code to use for center of nearest neighbor search.
  - `record_count` integer, required: Maximum number of nearest neighbors to count. The response reports how many records the search actually finds, up to this number.
  - `record_types` 'all' | 'likelytomove' | 'apartmentcomplex' | 'likelytodownsize' | 'likelytorefi' | 'absenteeowner' | 'highnetworth' | 'majorityhomeequity' | 'homefreeclear' | 'underwater' | 'kidsinhousehold' | 'newhomeowner' | 'firsttimehomebuyer' | 'renters' | 'retiring' | 'retired' | 'pool' | 'onlybusinesses' | 'newbusiness': Which type of records to search for
  - `include_condos` boolean: Include condos in search.

## Response `200`

Successful Response

- object
  - `status` string
  - `count` integer: Number of records the search found, up to record_count.
  - `failure` boolean

## Other responses

- `403`: Access token is missing or invalid
- `422`: Validation error. The request was refused before the search ran, so no count was performed.

## Changes

- **2026-09-24** `63c911a0e3c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thanks-io/apis/thanks-io-api/changes/mailing-lists-utils/count-radius-search/post.md)

---

[API](https://skmtc.dev/thanks-io/apis/thanks-io-api.md) · [All operations](https://skmtc.dev/thanks-io/apis/thanks-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thanks-io/apis/thanks-io-api/revisions/c403fbf3dc0f?raw)