Skip to content
GridRouterhome

Search

Search providers, capabilities and pages

Blocklist check API

deliverability.blocklist_check

Whether a sending domain or IP is on public blocklists.
providers document it
6

Providers

6 providers document blocklist check in their own API docs. None routes it through GridRouter yet. Scores appear as calls are routed.

What counts as a hit:
A listed or clean verdict for every list checked.

API

Same input for every provider. Set provider.sort to route by price, reliability or latency, or provider.only to pin providers; X-Grid-Max-Cost caps what one call can spend.

Inputs for deliverability.blocklist_check
InputDescription
target*Domain or IP (required)
Request
curl https://api.gridrouter.io/v1/run/deliverability.blocklist_check \
  -H "Authorization: Bearer $GRID_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Grid-Max-Cost: 0.05" \
  -d '{"input":{"target":"northwind.dev"},"provider":{"sort":"price"}}'

Fields

The normalized output every provider maps into. Suppliers come from integrated endpoint mappings (verified) or field names in each provider's API docs (claimed by the provider).

Every capability's fields
Output fields for Blocklist check
FieldTypePIIDescriptionSupplied by
targetstringNoneDomain or IPNot mapped yet
listedbooleanNoneOn any listNot mapped yet
listsarray<string>NoneLists that include itMail-tester
checked_atdatetimeNoneWhen checkedNot mapped yet