API Reference › Skip Tracing
Instant Trace Lookup
POST /v1/api/trace/lookup/
Cost: 5 credits per hit. 0 when nothing 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 skip trace for one address object or an array of up to 15 address objects. Returns responses immediately as JSON, no queue and no CSV. Ideal for one-off lookups or integrating skip trace data into your own UI at scale.
Array requests: wrap up to 15 of the same objects in a JSON array. Results stay in input order, each item is validated and billed independently, and the response returns results plus aggregate credits_deducted.
5 credits per hit, 0 credits on miss. Rate limited to 500 lookup items per minute per account; every object in an array counts as one item.
Two lookup modes:
- find_owner: true (default): send only address/city/state, returns the property owner(s) and their contact info
- find_owner: false: include first_name + last_name to search for a specific person at the address
Response includes per person: name, age, DOB, deceased flag, property owner flag, litigator flag, mailing address, all phones (with DNC + TCPA litigator status, carrier, type, rank), and all emails.
⚠️ 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: Enhanced Trace Lookup · Parcel ID (APN) Batch Trace · Parcel ID (APN) Lookup
Fields
address (required): Property street address
city (required): Property city
state (required): Property state (2-letter abbreviation)
zip: Property ZIP code. Optional but strongly recommended, without it, results may match a different property at a similar address in the same city.
find_owner: true (default) (find property owner, no name needed. false) find a specific person at the address, requires first_name + last_name.
first_name: Person's first name. Required when find_owner is false.
last_name: Person's last name. Required when find_owner is false.
Responses
200: Owner lookup hit (find_owner: true): 5 credits deducted
400: Missing fields / name required for person lookup
402: Insufficient credits
429: Rate limit reached: 500 lookups per minute per account, shared with the other instant lookups. Each array item counts as one.
503: Skip trace service temporarily unavailable