Overview

The Data page is where you run and manage IP enrichment jobs. You can upload a CSV of raw IP addresses, monitor processing status, download enriched results, and review job history.

Upload a CSV file

File requirements

• Format: .csv
• Required column: ip_address (header must match exactly)
• Recommended: deduplicate IPs before uploading — duplicate IPs in the same file count as one lookup but add processing time
• Additional columns are passed through unchanged in the output file

Steps

1. Click Upload CSV on the Data page.
2. Select your file or drag and drop it into the upload area.
3. Confirm the preview looks correct and click Start job.
4. The job appears in the job history with status Queued.

Concurrent job limits

Plan	Concurrent jobs
Free	1
Starter and above	3

If you are already at your concurrency limit, new jobs queue automatically and start when a slot opens.

Monitor job status

Jobs move through the following states:

Status	Meaning
Queued	Waiting for a processing slot
Processing	Actively enriching IPs
Complete	All IPs processed; results available
Failed	Job could not complete (see error message for cause)

The Data page shows real-time status for the active job and a history of all previous jobs.

Processing metrics

Once a job completes, the Data page shows summary metrics for that run:

• Total IPs submitted
• IPs matched to a business
• IPs filtered as infrastructure (cloud, CDN, VPN, proxy)
• IPs with no match (residential, ISP, unresolvable)
• Quota consumed

Download processed results

Click Download on any completed job to get the enriched CSV. The output file contains all original columns from your upload plus the Evident enrichment fields appended as new columns.

Enrichment fields added to output:

Column	Description
business_name	Company name
org_name	Legal/network organization name
hostname	Hostname associated with the IP
etld_plus_one	eTLD+1 domain
_industry	Industry classification
_industry_category	Broader industry category
_display_name	Display name for the organization
_confidence	Confidence score (0–1)
_quality	Composite quality score
_quality_score	Raw quality score
_completeness	Data completeness score
_quality_flags	Flags indicating quality issues
quality_metadata	Detailed quality metadata
_names_merged	Whether names were merged across providers
_extracted_business	Extracted business name
_extraction_source	Which provider supplied the result

Columns prefixed with _ are diagnostic fields. The business_name, org_name, hostname, and etld_plus_one columns are the primary fields for downstream use.

Quota and caching

Each unique company account identified in a job counts against your monthly limit. Multiple IPs that resolve to the same company count as one. An account already seen earlier in the same billing month does not count again. See Quotas for plan limits.

Troubleshooting

Job failed

Evident retries failed jobs up to 5 times automatically. If all retries fail, the job shows as Failed with an error message. Common causes:

• Monthly limit exceeded — you have reached your monthly tracked accounts limit. Your limit resets at the start of your next billing month. Consider upgrading if this happens regularly.
• Invalid file format — the uploaded file is missing the ip_address column or is not a valid CSV.
• Network error during processing — transient failure. Try re-uploading the file.

Job is stuck in the queue

Free accounts have lower queue priority than paid accounts. At times of high demand, free jobs may wait several hours. If a job has been queued for more than 24 hours, contact support.

Paid accounts have priority processing. If a paid account job is stuck for more than 30 minutes, contact support.