Allow & block lists

Override the verdict for addresses and domains you already know about.

How rules work#

A rule names an address (partner@example.com) or a domain (example.com). On every verification, list and API call for your account:

  • allow forces status: valid with reason: allowlisted.
  • block forces status: invalid with reason: blocklisted.
  • An address rule beats a domain rule, and block beats allow at the same level. Domain rules match that exact domain, not subdomains.
  • Malformed addresses are never overridden, and the original checks stay in the response. The result carries rule: "allow" or "block".

Manage them in the dashboard

Settings, then Filters. Rules cost no credits and take effect on the next check.

API#

GET/v1/rulesfree
POST/v1/rulesfree
FieldTypeDescription
actionallow | blockWhat to do with matches.
valuestringAn email address or a domain. Normalised to lowercase, IDN domains to punycode.
notestringOptional label, up to 200 characters.

Adding the opposite action for a value you already listed flips it. Up to 1,000 rules per account. DELETE /v1/rules/{id} removes one.

Add a rule
curl https://app.veridock.io/v1/rules \
  -H "Authorization: Bearer vd_live_…" \
  -H "Content-Type: application/json" \
  -d '{"action":"block","value":"throwaway-corp.example"}'

Related