> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thanks.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Radius Search Count

> 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.



## OpenAPI

````yaml post /mailing-lists-utils/count-radius-search
openapi: 3.1.0
info:
  title: thanks.io API
  description: >-
    Use the thanks.io API to send postcards, letters, notecards, windowless
    letters, and gift cards.
  contact:
    url: https://www.thanks.io
    email: support@thanks.io
  version: 1.0.0
servers:
  - url: https://api.thanks.io/api/v2
    description: The main API server for thanks.io
security:
  - bearerAuth: []
tags:
  - name: Recipients
  - name: Mailing Lists
  - name: Send Mailer
  - name: Orders
  - name: Message Templates
  - name: Image Templates
  - name: Handwriting Styles
  - name: Giftcards
  - name: Dynamic Images
    description: ''
  - name: Image Builder
  - name: Sub Accounts
  - name: Webhooks
  - name: Webhook Events
externalDocs:
  description: Learn more about thanks.io
  url: https://docs.thanks.io
paths:
  /mailing-lists-utils/count-radius-search:
    post:
      tags:
        - Mailing Lists
      summary: Radius Search Count
      description: >-
        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.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - address
                - postal_code
                - record_count
              properties:
                address:
                  type: string
                  example: 123 Main Street
                  description: Street address to use for center of nearest neighbor search.
                postal_code:
                  type: string
                  example: '55555'
                  description: Postal code to use for center of nearest neighbor search.
                record_count:
                  type: integer
                  description: >-
                    Maximum number of nearest neighbors to count. The response
                    reports how many records the search actually finds, up to
                    this number.
                  minimum: 1
                  maximum: 10000
                  example: 100
                record_types:
                  type: string
                  description: Which type of records to search for
                  enum:
                    - all
                    - likelytomove
                    - apartmentcomplex
                    - likelytodownsize
                    - likelytorefi
                    - absenteeowner
                    - highnetworth
                    - majorityhomeequity
                    - homefreeclear
                    - underwater
                    - kidsinhousehold
                    - newhomeowner
                    - firsttimehomebuyer
                    - renters
                    - retiring
                    - retired
                    - pool
                    - onlybusinesses
                    - newbusiness
                  default: all
                include_condos:
                  type: boolean
                  description: Include condos in search.
                  default: true
            examples:
              Count Before Buying:
                value:
                  address: 123 Main Street
                  postal_code: '55555'
                  record_types: all
                  record_count: 100
                  include_condos: true
      responses:
        '200':
          description: Successful Response
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: success
                  count:
                    type: integer
                    description: Number of records the search found, up to record_count.
                    example: 42
                  failure:
                    type: boolean
                    example: false
              example:
                status: success
                count: 42
                failure: false
        '403':
          $ref: '#/components/responses/Unauthorized'
        '422':
          description: >-
            Validation error. The request was refused before the search ran, so
            no count was performed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: The given data was invalid.
                  errors:
                    type: object
                    properties:
                      record_count:
                        type: array
                        items:
                          type: string
                        example:
                          - >-
                            The record count field must not be greater than
                            10000.
                  failure:
                    type: boolean
                    example: true
components:
  responses:
    Unauthorized:
      description: Access token is missing or invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthorized
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication using your thanks.io API key

````