Datascopes & Response Formats 🔎

Validation Types: Basic vs. Extended

For certain data types, you can choose how deep the API should dig to verify the information.

Emails

Basic Validation: Primarily checks if the email has the correct format and syntax (Regex). There is no domain check, so you will not know if the email address actually exists. It only corrects basic typos.
Extended Validation: Performs deep, multi-stage checks. It verifies domain MX records and communicates with the recipient's mail server to determine with high certainty whether the email address is active and deliverable. It also flags freemails or disposable (temporary) email addresses.

Phone Numbers

Basic Validation: Verifies the phone number against international formatting rules and standard numbering plans. It formats the output (e.g., adding the correct country code) but does not check if the number is currently active.
Extended Validation: Performs a real-time check (often via HLR lookup) to see if the phone number actually exists on the carrier's network and is reachable.

💰
Credit Consumption
Please note that Extended validations consume more credits than Basic validations due to the complex network requests required. The Data Cleaner will always provide an estimated credit cost in the final "Summary" step before execution.

Full Datascope (Data Enrichment)

By default, the Foxentry API returns a "Basic" datascope, which includes the validation status (valid/invalid) and the corrected string.

However, you can toggle on the Enrich data (Full Datascope) option in the settings. When enabled, Foxentry acts as a data enrichment tool, appending entirely new columns of valuable metadata to your output file.

What to expect in a Full Datascope:

Locations: Returns detailed administrative data, including region, district, precise GPS coordinates, and specific city parts.
Companies: Retrieves extensive public registry information, such as exact legal form, VAT payer status, dates of incorporation, number of employees, and full NACE industry codes.
Names: Identifies the gender associated with the name, provides the correct vocative case (e.g., for personalized email greetings), and identifies name days.

API Reference Links

To see the exact structure of the enriched data returned by our endpoints, refer to our comprehensive API references:

Next step: Once your datascopes are configured and the process is finished, you need to understand how the results are presented. Learn more in the Output Structure & Audit Logs section.