Contacts

post

https://www.klooksintelligence.com/contacts

Retrieves and processes contacts (emails and/or phone numbers) from a Brazilian company by CNPJ.

Features:

Retrieves emails and phone numbers from company officers (QSA) and optionally employees (EMPLOYEE)
Email validation via advanced verification services
WhatsApp validation on phone numbers
AI-powered name inference from email patterns
Advanced filters (validation, corporate)

Credit system:

QSA basic: 0.004 credits
QSA with validations: 0.024 - 0.1 credits
FULL basic: 0.004 credits
FULL with validations: 0.288 - 1.008 credits

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

cnpj

string

required

Company CNPJ (with or without formatting)

include_employees

boolean

Defaults to true

If true, retrieves contacts from officers (QSA) + employees (EMPLOYEE).
If false, retrieves only officers (QSA).
WARNING: FULL (true) costs more credits than QSA only (false).

include_emails

boolean

Defaults to true

Include emails in results

include_phones

boolean

Defaults to false

Include phone numbers in results

validate_emails

boolean

Defaults to true

Enables advanced email validation, returning only contacts with high probability of validity.
Contacts are classified and filtered according to confidence levels: "ok" (valid with high confidence) and "ok_for_all" (valid for all applications).
Increases deliverability rate and reduces bounces in email marketing campaigns.

validate_whatsapp

boolean

Defaults to false

Enables verification of active WhatsApp existence on phone numbers.
Performs real-time verification if the number has an active WhatsApp account, allowing campaigns and communications to be directed to channels with higher response rates.
Requires include_phones=true.

validation_levels

array of strings

Defaults to ok,ok_for_all

Defines accepted confidence levels for validated emails.
Recommended values: ["ok", "ok_for_all"] - high probability of validity and deliverability.
Other available levels: "catch_all" (accepts all emails), "unknown" (inconclusive validation), "disposable" (temporary email).
Applied only when validate_emails=true.

validation_levels

Allowed:

corporate_only

boolean

Defaults to false

Filter only corporate emails (excludes gmail, hotmail, etc).
Removes personal emails from results.

infer_names

boolean

Defaults to true

Infer names from emails using artificial intelligence.
The AI analyzes email patterns and structures to intelligently extract the likely contact name.
Adds inferred_name field to contacts.

use_cache

boolean

Defaults to true

Use cache if available.
Cache expires when parameters change.
IMPORTANT: validate_whatsapp always ignores cache.

Responses

200Success

400Bad request

401Authentication required

403Unauthorized (invalid credentials or limit exceeded)

500Internal server error