disban-io Auth API
The Auth API from disban-io — 5 operation(s) for auth.
The Auth API from disban-io — 5 operation(s) for auth.
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-auth-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 Auth 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: Auth
paths:
/api/auth/account/sessions:
get:
operationId: countAccountSessions
summary: Count your active browser sessions
security:
- sessionCookie: []
responses:
'200':
description: Active session count
content:
application/json:
schema:
type: object
'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:
- Auth
/api/auth/account/{action}:
post:
operationId: manageAccount
summary: Session and deletion controls
security:
- sessionCookie: []
description: Requires a browser session and a fresh action-bound email code requested with intent account. Sign-out-all invalidates every browser session; API keys remain active. Delete-history preserves monthly usage. Delete-account removes the active account, sessions, keys, usage and activity; it does not rewrite independently collected domain intelligence or existing backups.
parameters:
- in: path
name: action
required: true
schema:
type: string
enum:
- sign-out-all
- delete-history
- delete-account
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
challenge_id:
type: string
code:
type: string
pattern: ^(?:[0-9]{6}|[a-f0-9]{32})$
writeOnly: true
confirmation:
type: string
enum:
- DELETE
description: Required for both deletion actions.
required:
- challenge_id
- code
responses:
'200':
description: Account action completed
content:
application/json:
schema:
type: object
'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:
- Auth
/api/auth/otp/request:
post:
operationId: requestEmailCode
summary: Check a signup email and queue a one-time code
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
intent:
type: string
enum:
- signup
- login
- account
email:
type: string
format: email
name:
type: string
maxLength: 80
plan_id:
type: string
enum:
- free
referral_code:
type: string
maxLength: 24
description: Optional referral code; attached only when a new email-verified account is created.
action:
type: string
enum:
- sign-out-all
- delete-history
- delete-account
required:
- intent
description: Signup requires name/email and passes the backend checker. Login requires email. Account actions require a session and ignore client-supplied email. The response confirms queuing, not delivery. Codes expire 10 minutes after the request and become usable only after the email provider accepts delivery. Resend is limited to once per minute. No account is created until verification.
responses:
'200':
description: Generic delivery acknowledgement with challenge_id
content:
application/json:
schema:
type: object
'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:
- Auth
/api/auth/otp/verify:
post:
operationId: verifyEmailCode
summary: Consume a one-time code and start a session
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
intent:
type: string
enum:
- signup
- login
challenge_id:
type: string
minLength: 64
maxLength: 64
code:
type: string
pattern: ^(?:[0-9]{6}|[a-f0-9]{32})$
writeOnly: true
required:
- intent
- challenge_id
- code
responses:
'200':
description: Verified account and HttpOnly session cookie
content:
application/json:
schema:
$ref: '#/components/schemas/Account'
'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:
- Auth
/api/auth/logout:
post:
operationId: logout
security:
- sessionCookie: []
requestBody:
required: true
content:
application/json:
schema:
type: object
responses:
'200':
description: Session ended
content:
application/json:
schema:
type: object
'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:
- Auth
summary: Logout
x-summary-source: derived
components:
schemas:
Account:
type: object
properties:
user:
type: object
properties:
id:
type: string
name:
type: string
email:
type: string
format: email
required:
- id
- name
- email
required:
- user
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