disban-io Keys API
The Keys API from disban-io — 2 operation(s) for keys.
The Keys API from disban-io — 2 operation(s) for keys.
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-keys-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 Keys 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: Keys
paths:
/api/keys:
get:
operationId: listKeys
security:
- sessionCookie: []
responses:
'200':
description: Key metadata only; no secrets
content:
application/json:
schema:
type: object
properties:
keys:
type: array
items:
$ref: '#/components/schemas/Key'
required:
- keys
'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:
- Keys
summary: List keys
x-summary-source: derived
post:
operationId: createKey
summary: 'Issue an API key within the plan limit (Free: one active key)'
security:
- sessionCookie: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 80
required:
- name
responses:
'201':
description: Store token now; it is returned only once
content:
application/json:
schema:
type: object
properties:
token:
type: string
key:
$ref: '#/components/schemas/Key'
required:
- token
- key
'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:
- Keys
/api/keys/{id}:
delete:
operationId: revokeKey
security:
- sessionCookie: []
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Revoked; subsequent checks reject the key
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'
'404':
description: Active key not found
content:
application/json:
schema:
type: object
'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:
- Keys
summary: Revoke key
x-summary-source: derived
components:
schemas:
Key:
type: object
properties:
id:
type: string
name:
type: string
prefix:
type: string
created_at:
type: string
format: date-time
last_used_at:
type:
- string
- 'null'
revoked_at:
type:
- string
- 'null'
required:
- id
- name
- prefix
- created_at
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