API Reference › Property Search
Property Lookup
POST /v1/api/property-search/lookup/
Cost: 10 credits per property found, with or without contacts. 0 when no property is found.
Rate limit: 500 lookups per minute per account, shared with the other instant lookups. Each array item counts as one.
Mode: Sync
Synchronous single-address version of /execute/, one address in, one address out. Use this when you already have a specific address and want the complete data (property attributes, owner, full skip trace) in a single API call.
Two lookup modes (mutually exclusive):
- Address: send address + city + state (+ optional zip_code).
- APN: send apn + county + state to enrich a normalized parcel number (e.g. one returned by APN Autocomplete). An APN is only unique within a county, so county + state are required to resolve the right parcel. The response shape is identical to address mode.
Sending both address and apn in the same request is a 400.
Billing: 10 credits per property hit:
- Property found + skip trace hit → 10 credits, full phones/emails + all compliance flags
- Property found + skip trace miss → 10 credits, full property data, empty contacts block
- Property NOT found → 0 credits, hit: false
Priced at 2× the /v1/api/trace/lookup/ endpoint (5 credits) because this lookup returns the full property dossier (50+ Attributes) *in addition to* skip-trace contacts. If you only need phones and emails for an address (no property attributes), use instant trace instead, same skip-trace data, half the cost.
ZIP code: optional but *strongly recommended*, without it, common street names can match the wrong property in a large city.
Rate limit: 500 requests per minute.
⚠️ Compliance: Phones returning litigator: true or dnc: true should not be called for telemarketing or cold outreach without documented prior express written consent. TCPA violations can carry penalties. You are solely responsible for compliance with TCPA, FDCPA, and DNC regulations. These flags are informational, not legal advice.
Related endpoints: Address Autocomplete · APN Autocomplete · TraceAI Assist
Fields
address: Address mode: property street address. Example: "4521 E Monte Cristo Ave". Required in address mode; omit in APN mode.
city: Address mode: property city. Required in address mode.
zip_code: Address mode: property ZIP. Optional but strongly recommended for accuracy.
apn: APN mode: Assessor's Parcel Number. The leading '#' is optional. Required in APN mode; mutually exclusive with address.
county: APN mode: county the parcel is in. Required in APN mode (an APN is only unique within a county).
state (required): Property state (2-letter code). Required in BOTH modes.
Responses
200: Hit: 10 credits deducted
402: Insufficient credits
403: Account suspended (unpaid invoices)
429: Rate limit reached: 500 lookups per minute per account, shared with the other instant lookups. Each array item counts as one.
503: Upstream temporarily unavailable