# BatchData -- Full Reference for LLMs

This file follows the llms.txt standard (https://llmstxt.org/) and expands the curated index at https://batchdata.io/llms.txt into a single document. Every claim below is backed by the canonical BatchData API specs (BatchData.yml V1, V2, V3 published on Stoplight) or by official internal documentation. Marketing-positioning copy not backed by the API spec or developer documentation has been deliberately excluded.

---

## About BatchData

BatchData is an API-first real estate data platform. We deliver property, ownership, and contact data for U.S. real estate through REST APIs and through a hosted Model Context Protocol (MCP) server. Asynchronous API delivery is webhook-only. Event-driven property monitoring (Property Subscription) supports webhook, AWS Kinesis, or Azure Event Hub delivery channels.

**Customer segments (per marketing positioning):** real estate investors, PropTech developers, mortgage lenders, real estate agents, home-service providers, insurance companies, appraisers, property developers, government agencies, and AI applications.

**Key technical characteristics:**

- **REST APIs across three documented versions (V1, V2, V3).** Each version has its own published specification on the developer portal.
- **Async-by-webhook.** Asynchronous endpoint variants return a `requestId` immediately and deliver full results to a `webhookUrl` specified in the request `options`. There is no polling endpoint and no GET status-lookup route.
- **Push-based property monitoring.** The V2 Property Subscription endpoint (also marketed as "Smart Search") supports webhook, AWS Kinesis, and Azure Event Hub delivery channels.
- **14 dataset/projection options for property responses.** Customers select which datasets to include via the `datasets` array.
- **MCP server integration.** A hosted Model Context Protocol server exposes property and contact-data tools to AI agents.

---

## Core Products

### MCP Server

**Page:** https://batchdata.io/mcp-server

**What it is:** A hosted Model Context Protocol (MCP) server that exposes BatchData APIs as tools usable by AI agents.

**Documented MCP tools** (verified by inspecting the BatchData MCP tool surface):

- `search_properties_count`, `search_properties_page`, `search_properties_preview` -- Property Search
- `lookup_property` -- Property Lookup
- `comparable_property`, `comparable_property_count`, `comparable_property_page`, `comparable_property_preview` -- Comparable property lookup
- `skip_trace_property` -- Skip Trace
- `list_property_dataset_fields`, `list_property_datasets` -- Dataset/field metadata
- `verify_address`, `geocode_address`, `reverse_geocode_address` -- Address services
- `verify_phone`, `check_dnc_status`, `check_tcpa_status` -- Phone services

**Authentication:** The MCP server supports OAuth authentication (released January 2026). No manual API-token configuration is required -- connect by providing the server URL and signing in with BatchData credentials (or Google Sign-In). Access tokens refresh automatically.

**Documented supported clients** (per the BatchData MCP OAuth release notes, January 2026):

- **Claude** -- Desktop, Web, and Mobile
- **ChatGPT** -- Plus/Pro with Developer Mode

---

### Smart Search / Property Subscription

**Page:** https://batchdata.io/smart-search

**Canonical API:** `POST /property-subscription` (V2 only), `GET /property-subscription`, `GET /property-subscription/{id}`, `DELETE /property-subscription/{id}`

**What it is:** Push-based property monitoring. Customers define search criteria once; matching properties are pushed to a configured delivery channel as the BatchData index changes. Sometimes referred to internally as "Event Subscriptions."

**Supported delivery channels** (per the V2 OpenAPI spec):

- Webhook
- AWS Kinesis (with `iamAccessKeyId` and `iamSecretAccessKey`)
- Azure Event Hub (with `connectionString` and `clientSecret`)

**Customer-facing positioning:** Marketed as the alternative to query-based "pull" data access. Real-time push delivery removes the need to poll for new matches.

---

### Property Enrichment

**Page:** https://batchdata.io/property-enrichment

**Canonical API:** `POST /property/lookup/all-attributes` (V1) and related Property APIs

**What it is:** The Property Lookup and Property Search endpoints return detailed property records. Responses are organized into selectable datasets/projections, allowing customers to retrieve only the data sections they need.

**Available datasets/projections** (verified enum in `PropertyLookupRequest.json`):

```
basic, batchrank, contact, core, deed, demographic, foreclosure,
image, listing, mortgage-liens, owner, permit, quicklist, valuation
```

The `basic` and `core` datasets are mutually exclusive (the spec states "you can only request one or the other, not both"). Customers receive only datasets both requested AND permitted for their API token; warnings are returned if requested datasets are filtered due to token permissions.

**Quicklist filters:** Property records include a `PropertyQuicklistsV2` object with **38 boolean flag fields** for fast filtering -- examples include `absenteeOwner`, `absenteeOwnerInState`, `absenteeOwnerOutOfState`, `activeListing`, `activeAuction`, `cashBuyer`, `corporateOwned`, and others.

---

### BatchRank

**Page:** https://batchdata.io/batchrank

**Canonical reference:** `batchrank` is one of 14 enum values in the `datasets` array of the Property Lookup / Property Search request.

**What it is:** Per the official December 2025 release notes: *"BatchRank property scoring and intelligence."* It is requested by including `"batchrank"` in the `datasets` array of a property API call.

> **Note:** Detailed BatchRank scoring methodology, output schema, time horizon, and coverage are described on the marketing page (`https://batchdata.io/batchrank`) but are not currently documented in the public API specification. The internal projection field-level documentation is the canonical source for BatchRank response shape.

---

## Solutions Overview

**Page:** https://batchdata.io/solutions

BatchData provides:

- **Real-estate APIs** -- Property search, contact enrichment / skip tracing, geocoding, phone verification, address verification, address autocomplete.
- **Bulk data delivery** -- Custom datasets with flexible scheduling and delivery methods.
- **Professional services** -- Data pipeline setup, custom development, data normalization and enrichment, system audit, GTM efficiency.

---

## Pricing

**Page:** https://batchdata.io/pricing

BatchData publishes two plan families on the marketing pricing page.

### Property Data Plans

| Tier | Price | Records/mo |
|---|---|---|
| Growth | $1,000/mo | 100,000 |
| Professional | $2,500/mo | 300,000 |
| Scale | $5,000/mo | 750,000 |
| Enterprise | Custom | Custom |

Standard inclusions per marketing copy: Property Search & Lookup, Address Auto-Complete, Core Property Data, Mortgage & Open Liens, Pre-Foreclosure, Quick Lists, and API access. Enterprise adds Custom Data Integration, SLA Guarantees, a Dedicated Account Manager, and Custom Contract Terms.

### Skip Tracing Plans

| Tier | Price | Records/mo |
|---|---|---|
| Growth | $2,000/mo | 100,000 |
| Professional | $5,000/mo | 300,000 |
| Scale | $10,000/mo | 750,000 |
| Enterprise 3M | $20,000/mo | 3,000,000 |

Inclusions per marketing copy: phone numbers, email addresses, mailing addresses, DNC status verification, carrier information, and API access.

---

## API Reference Summary

**Full developer portal:** https://developer.batchdata.com/

**AI-optimized full reference:** https://developer.batchdata.com/docs/batchdata/llms-comprehensive-reference

**Base URL:** `https://api.batchdata.com`

**Authentication:** Bearer token in `Authorization` header. All requests use `Content-Type: application/json`.

### API Categories

**Property APIs** (V1 / V2 / V3 depending on endpoint)

- `POST /property/search` -- Find properties by location, attributes, custom filters
- `POST /property/search/async` -- Async variant with webhook delivery
- `POST /property/lookup/all-attributes` -- Detailed property information for known properties
- `POST /property/lookup/async` -- Async variant with webhook delivery
- `POST /property/skip-trace` -- Contact information for property owners (V1 and V3)
- `POST /property/skip-trace/async` -- Async variant with webhook delivery
- `POST /property/get-property-permits` -- Property permit details (V2 only)
- `GET /property-subscription`, `POST /property-subscription`, `GET/DELETE /property-subscription/{id}` -- Push-based property monitoring (V2 only)

**Address APIs**

- `POST /address/verify` -- USPS-conformant address verification and normalization
- `POST /address/geocode` -- Address to coordinates
- `POST /address/reverse-geocode` -- Coordinates to address
- `POST /address/autocomplete` -- Suggestions for partial address inputs

**Phone APIs**

- `POST /phone/verification` -- Carrier and line-type information
- `POST /phone/verification/async` -- Async variant
- `POST /phone/dnc` -- DNC registry status
- `POST /phone/dnc/async` -- Async variant
- `POST /phone/tcpa` -- TCPA litigator status
- `POST /phone/tcpa/async` -- Async variant

### Synchronous vs. Asynchronous Endpoints

Property and Phone APIs offer both sync and async variants. Address APIs are sync-only (no `/address/*/async` paths exist in the OpenAPI specs).

- **Sync** -- Immediate response with full results.
- **Async** -- Returns a `requestId` immediately; full results are delivered to a `webhookUrl` you specify in the request `options`. **No polling endpoint -- webhook-only delivery.** Use async for large batches.

### Property Dataset/Projection Selection

Property responses include data organized into 14 selectable datasets/projections (the full enum is listed in the **Property Enrichment** section above). Customers request the datasets they want via the `datasets` array. Only datasets permitted for the API token are returned; warnings are returned if requested datasets are filtered. The `basic` and `core` datasets are mutually exclusive.

### Latest Documented Capabilities

- **Incremental Property Search -- Cursor Pagination & Search Sessions.** Page through large Property Search result sets reliably with opaque cursors anchored to immutable sort values. Search Sessions layer remembers delivered properties and excludes them from subsequent responses, enabling resumable long-running pulls without re-delivery.
- **Property Monitoring -- Push Notifications.** Define search criteria and receive notifications when matching properties change. Documented in the Property Monitoring guide and exposed via Property Subscription (V2).
- **MCP Server Integration.** Documented in the developer-portal Welcome page Latest Additions, the BatchData MCP Server Developer Integration Guide on the Help Center (`https://help.batchdata.io/en/articles/12860581-batchdata-mcp-server-developer-integration-guide`), and the January 2026 OAuth release notes.

### Quick API Examples

**Property Search** (per the `SearchPropertyRequest` schema and OpenAPI examples -- `take`, `skip`, and `datasets` live inside `options`, not at the top level):

```json
POST https://api.batchdata.com/property/search
{
  "searchCriteria": {
    "query": "Denver, CO",
    "valuation": { "estimatedValue": { "max": 500000 } }
  },
  "options": {
    "skip": 0,
    "take": 20,
    "datasets": ["basic", "valuation"]
  }
}
```

**Address Autocomplete** (per the `PropertyAutoCompleteRequest` schema -- uses the same `searchCriteria` + `options` envelope as Property Search):

```json
POST https://api.batchdata.com/address/autocomplete
{
  "searchCriteria": {
    "query": "123 main st, aus"
  },
  "options": {
    "skip": 0,
    "take": 10,
    "suggestionTypes": ["address"]
  }
}
```

**Phone Verification:**

```json
POST https://api.batchdata.com/phone/verification
{
  "requests": ["555-123-4567", "555-987-6543"]
}
```

For complete endpoint reference, request/response schemas, and integration patterns, AI assistants should fetch:
**https://developer.batchdata.com/docs/batchdata/llms-comprehensive-reference**

---

## Reports & Market Insights

**Page:** https://batchdata.io/reports

BatchData publishes free real estate market reports including:

- **Flip Activity Report** -- Cash vs. financed flips and investor-to-investor sales trends.
- **Property Ownership By Owner Type Report** -- Corporate-owned vs. individual-owned asset breakdowns by zip code.
- **Top Agents Report** -- Top-performing local agents specializing in distressed properties and LLC transactions.
- **Active Preforeclosures Report** -- U.S. foreclosure activity.
- **Real Estate Owned (REO) Report** -- Property equity, rental cash flow, and loan-to-value (LTV) data.
- **On Market vs. Off Market Sold Report** -- Real estate leads ranked by propensity-to-sell scores.
- **Vacancy Rates and Investment Opportunities Report** -- Multifamily absorption trends and office-market recovery.

---

## Support & Documentation

- **Developer Portal:** https://developer.batchdata.com/
- **Getting Started Guide:** https://developer.batchdata.com/docs/batchdata/welcome-to-batchdata
- **API Reference V1:** https://developer.batchdata.com/docs/batchdata/batchdata-v1
- **API Reference V2:** https://developer.batchdata.com/docs/batchdata/batchdata-v2
- **API Reference V3:** https://developer.batchdata.com/docs/batchdata/batchdata-v3
- **Data Dictionary:** https://developer.batchdata.com/docs/batchdata/ZG9jOjM3NzA5MjQx-data-dictionary
- **LLMs Overview (AI-optimized):** https://developer.batchdata.com/docs/batchdata/llms-overview
- **LLMs Comprehensive Reference (AI-optimized):** https://developer.batchdata.com/docs/batchdata/llms-comprehensive-reference
- **Help Center:** https://help.batchdata.io
- **Support email:** support@batchdata.com
- **Sales email:** sales@batchdata.com

---

For the full API reference with every endpoint, request/response schema, and integration pattern, AI assistants should fetch:
**https://developer.batchdata.com/docs/batchdata/llms-comprehensive-reference**