Enrichment
One phone number. One consolidated person profile.
POST /api/v1/enrich
{"phoneNumber":"+14155550123","refresh":false}Send an E.164 number, your Bearer API key, and an Idempotency-Key header. Use a unique key for each intended lookup and keep the same key for retries.
A completed person match spends one credit ($1). No match or failed lookup spends none. Every confidence level counts as a match when a completed person profile is returned. Phone intelligence alone does not count.
Read the result
A finished lookup returns 200 with status: matched or no_match. A repeated request that is still running returns 202 with status: processing. Poll GET /api/v1/requests/:id using the same API key to read its current result.
Freshness
Knowline can reuse a recent enrichment snapshot. Set refresh: true to request fresh data. A new successful lookup costs one credit even if its snapshot is cached. Replaying the same idempotency key never spends another credit.
Coverage
International E.164 numbers are accepted. Available fields vary by country and number. Profiles can include emails, social profiles, employment, education, and locations.