Enrichment
Request a consolidated Knowline profile, or inspect the underlying lookup records.
Consolidated enrichment
{
"phoneNumber": "+14155550123",
"refresh": false
}| Field | Required | Meaning |
|---|---|---|
phoneNumber | Yes | An E.164 phone number. |
refresh | No | Bypass the cache and request new data. Defaults to false. |
Knowline gathers eligible person records and phone intelligence, then consolidates the available evidence into a structured profile. Individual lookup failures remain visible in the response.
Underlying lookup records
{
"phoneNumber": "+14155550123",
"provider": "all"
}The raw endpoint supports a default sequential lookup or a parallel lookup across eligible sources. Its failure behavior differs from consolidated enrichment.
| Selection | Behavior |
|---|---|
Omitted or default | Try person lookup sources in sequence, stopping at the first match. A source failure stops the request. |
all | Query eligible person and phone lookup sources concurrently. A source failure fails the raw request. |
Available data
Profiles can include names, aliases, emails, social profiles, work and education history, and locations. Phone intelligence can include number validity, carrier, line type, and caller-name information. Number intelligence alone is not a person match.
Coverage
Knowline accepts international E.164 numbers. Some person datasets cover only +1 numbers, and number-intelligence packages have country-specific limitations. Available fields vary by number, country, and source coverage.
Cache and freshness
When present, cache.status is hit, miss, refresh, or disabled. generatedAt and expiresAt describe the enrichment snapshot. They do not establish when every underlying fact was last verified.