disban-io Webhooks API
The Webhooks API from disban-io — 1 operation(s) for webhooks.
The Webhooks API from disban-io — 1 operation(s) for webhooks.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/disban-io:disban-io-webhooks-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Disban Webhooks API
version: 1.0.0
description: 'Email-domain classification API (Free beta). Free plan: 2,000 checks per UTC month. No payment or automatic billing. Check credits are metered per successful domain, including cache hits. Plan changes retain usage.'
servers:
- url: https://disban.io
tags:
- name: Webhooks
paths:
/api/webhooks/check:
post:
operationId: receiveChecks
security:
- bearerAuth: []
- sessionCookie: []
description: Inbound push endpoint. Returns ordered results in this response; no outbound callback. Defaults to lookup-only and queues unknown domains for discovery. Same quotas and batch limits as /api/batch.
parameters:
- name: realtime
in: query
schema:
type: boolean
default: false
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- type: object
properties:
input:
type: string
required:
- input
- type: object
properties:
inputs:
type: array
minItems: 1
maxItems: 50
items:
type: string
required:
- inputs
responses:
'200':
description: Ordered results
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/Verdict'
required:
- results
'400':
description: Request could not be completed
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Request could not be completed
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Request could not be completed
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Request could not be completed
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Request could not be completed
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'415':
description: Request could not be completed
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate or quota limit; honor Retry-After
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
headers:
Retry-After:
schema:
type: integer
description: Seconds until retry
'502':
description: Request could not be completed
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: Request could not be completed
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Webhooks
summary: Receive checks
x-summary-source: derived
components:
schemas:
Verdict:
type: object
properties:
domain:
type: string
category:
type: string
enum:
- disposable
- free
- alias
- testing
- parked
- unknown
reason:
type: string
status:
type: integer
const: 200
email:
type:
- string
- 'null'
description: Request-only echo; never persisted in history.
normalized_email:
type:
- string
- 'null'
description: Domain normalized; local-part case preserved. Null for domain-only requests and history.
domain_authority:
type:
- number
- 'null'
domain_age_in_days:
type:
- integer
- 'null'
mx:
type:
- boolean
- 'null'
description: Fresh explicit non-null MX present. False for Null MX or confirmed absence; null when unverified. False does not exclude implicit SMTP routing.
mx_records:
type:
- array
- 'null'
items:
type: object
properties:
hostname:
type: string
priority:
type:
- integer
- 'null'
required:
- hostname
- priority
mx_providers:
type:
- array
- 'null'
items:
type: object
properties:
slug:
type: string
type:
type: string
grade:
type:
- string
- 'null'
required:
- slug
- type
- grade
spf:
type:
- string
- 'null'
dmarc:
type:
- string
- 'null'
public_domain:
type:
- boolean
- 'null'
relay_domain:
type:
- boolean
- 'null'
free_subdomain:
type:
- boolean
- 'null'
alias:
type:
- boolean
- 'null'
role_account:
type:
- boolean
- 'null'
spam:
type:
- boolean
- 'null'
did_you_mean:
type:
- string
- 'null'
disposable:
type:
- boolean
- 'null'
description: Null for unresolved classification; never treat null as clean.
cached:
type: boolean
historical_disposable:
type: boolean
description: 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.
mail_routing:
type: object
properties:
status:
type: string
enum:
- routable
- invalid
- unknown
reason:
type: string
observed_at:
type: string
format: date-time
expires_at:
type: string
format: date-time
review_required:
type: boolean
required:
- status
- reason
matched_on:
type: string
latency_ms:
type: number
required:
- domain
- category
- reason
Error:
type: object
properties:
error:
type: string
code:
type: string
retry_after:
type: integer
required:
- error
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: dbn_ API key; check, batch, inbound check webhook and read-only subscription
sessionCookie:
type: apiKey
in: cookie
name: disban_session