post/api/check

Request

  • Base URL: https://disban.io
  • URL: https://disban.io/api/check
  • Auth: one of:
    • HTTP bearer
    • API key in cookie disban_session

Query parameters

realtimeboolean

false uses stored fresh evidence only; true waits for bounded live routing. Omit to preserve the standard verification flow.

Request body

inputstring required

Example request

{
  "input": "sharklasers.com"
}

Response

Classification; consumes one credit

domainstring required
category'disposable' | 'free' | 'alias' | 'testing' | 'parked' | 'unknown' required
reasonstring required
status200
emailstring nullable

Request-only echo; never persisted in history.

normalized_emailstring nullable

Domain normalized; local-part case preserved. Null for domain-only requests and history.

domain_authoritynumber nullable
domain_age_in_daysinteger nullable
mxboolean nullable

Fresh explicit non-null MX present. False for Null MX or confirmed absence; null when unverified. False does not exclude implicit SMTP routing.

spfstring nullable
dmarcstring nullable
public_domainboolean nullable
relay_domainboolean nullable
free_subdomainboolean nullable
aliasboolean nullable
role_accountboolean nullable
spamboolean nullable
did_you_meanstring nullable
disposableboolean nullable

Null for unresolved classification; never treat null as clean.

cachedboolean
historical_disposableboolean

Records existing list or reviewed seed history, independently of current classification. Can be true for currently confirmed disposable services; it is not a low-confidence flag and is not proof of current operation.

matched_onstring
latency_msnumber

Changes

No recorded changes to this operation across all 1 revision of this API.