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: validwithreason: allowlisted. - block forces
status: invalidwithreason: 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
checksstay in the response. The result carriesrule: "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
| Field | Type | Description |
|---|---|---|
| action | allow | block | What to do with matches. |
| value | string | An email address or a domain. Normalised to lowercase, IDN domains to punycode. |
| note | string | Optional 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