disban-io

disban-io Auth API

The Auth API from disban-io — 5 operation(s) for auth.

Documentation GitHub OpenAPI

Operations 5

GET /api/auth/account/sessions Count your active browser sessions #

POST /api/auth/account/{action} Session and deletion controls #

POST /api/auth/otp/request Check a signup email and queue a one-time code #

POST /api/auth/otp/verify Consume a one-time code and start a session #

POST /api/auth/logout Logout #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/disban-io:disban-io-auth-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API 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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

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

disban-io Auth API

Operations 5

Documentation

Specifications

Schemas & Data

Other Resources