Batch Trace

POST /v1/api/trace/

Cost: Per hit: 1 credit (normal), 2 (advanced), 15 (enhanced). Rows with no match cost nothing.

Rate limit: 10 batch trace submissions per 5 minutes per account.

Mode: Async: returns a queue ID, results arrive by download link and webhook.

Asynchronous batch endpoint for processing multiple addresses at once via CSV or JSON. Specify trace_type='normal' (1 credit/lead), 'advanced' (2 credits/lead), or 'enhanced' (15 credits/lead). Enhanced batch traces require first and last name columns and target each supplied person at the associated address. Cleans and de-duplicates rows, then enqueues processing in the background. If credits are insufficient the request is rejected. Returns a queue_id immediately along with estimated_wait_seconds (estimated processing time in seconds); results are delivered via download_url when complete. For single-address instant lookups, use the Instant Trace Lookup endpoint instead. ⚠️ API Usage Policy: Do not abuse API POST calls. Accounts found to be abusing the API will be put on hold. Maximum rate limit is 10 POST trace requests per 5-minute window. Please use the API responsibly and in accordance with our Terms of Service - API Rate Limits & Abuse Policy. Related endpoints: Instant Trace Lookup · Enhanced Trace Lookup · Parcel ID (APN) Batch Trace

Fields

address_column (required): Column for property address
city_column (required): Column for property city
state_column (required): Column for property state
zip_column: Property ZIP. Optional but recommended.
first_name_column: Person first-name column. Required for normal, custom, and enhanced traces. Not used by advanced owner lookup.
last_name_column: Person last-name column. Required for normal, custom, and enhanced traces. Not used by advanced owner lookup.
mail_address_column: Mailing address column. Required for normal traces; optional for advanced/enhanced traces.
mail_city_column: Mailing city column. Required for normal traces; optional for advanced/enhanced traces.
mail_state_column: Mailing state column. Required for normal traces; optional for advanced/enhanced traces.
mailing_zip_column: Mailing ZIP column. Optional.
trace_type: Trace type: 'normal' (1 credit/lead), 'advanced' (2 credits/lead), or 'enhanced' (15 credits/lead). Defaults to 'normal'. Advanced discovers the owner from an address; Enhanced requires first and last name columns.
csv_file: CSV file of records. Send exactly one of csv_file or json_data.
json_data: The records as a JSON array, sent as a form field (alternative to csv_file).

Responses

200: Success.
400: Column not found in your data
402: Insufficient credits (prepaid account)
429: Rate limit reached: 10 batch trace submissions per 5 minutes per account.
503: Enhanced trace temporarily unavailable