Country inference

mc.api.infer_record_country([
    {"record_id": "1", "emails": ["test@example.com"]}
])

Returns a most-likely country per record.

Parameters

list[dict]

required

Record objects (1–500), each with record_id + any of emails / phones / name.

bool

default:"False"

Validate input locally without sending.

Response shape

result = mc.api.infer_record_country([{"record_id": "1", "emails": ["test@example.com"]}])
# {
#   "results": [
#     {"record_id": "1", "inferred_country": "US", "confidence": ...}
#   ]
# }

Validation

dry_run=True returns the validated InferCountryRequest without sending; an empty records list raises MinervaValidationError locally. See Validation.

Getting started

Endpoints

Power features

Reference

Parameters

Response shape

Validation

​Parameters

​Response shape

​Validation

Parameters

Response shape

Validation