IBANforge API Keys API
API key management — generate free keys and check usage
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ibanforge-api-keys-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Ibanforge API Keys API
version: 1.4.3
contact:
url: https://ibanforge.com
description: 'Operations tagged API Keys across 2 of this provider''s published API definitions: ibanforge-api-keys-api-openapi.yml, ibanforge-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.ibanforge.com
description: Production
- url: http://localhost:3000
description: Local development
tags:
- name: API Keys
description: API key management — generate free keys and check usage
paths:
/v1/keys/generate:
servers:
- url: https://api.ibanforge.com
description: Production
- url: http://localhost:3000
description: Local development
post:
operationId: generateApiKey
summary: Generate a free API key
description: Generates a free API key with 200 requests/month quota (batch validation counts 1 request per IBAN). One key per email per day.
tags:
- API Keys
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- email
properties:
email:
type: string
format: email
description: Email address for key registration
responses:
'201':
description: API key generated (shown only once)
'400':
description: Invalid email
'429':
description: Rate limited — one key per email per day
/v1/keys/usage:
servers:
- url: https://api.ibanforge.com
description: Production
- url: http://localhost:3000
description: Local development
get:
operationId: getApiKeyUsage
summary: Check API key usage
description: Returns current month usage and remaining quota for the provided API key.
tags:
- API Keys
security:
- apiKey: []
responses:
'200':
description: Usage statistics for the current month
'401':
description: Missing or invalid API key
/stats:
servers:
- url: https://api.ibanforge.com
description: Production
- url: http://localhost:3000
description: Local development
get:
operationId: getStats
summary: Detailed statistics
description: Returns detailed API usage statistics broken down by operation type. Requires authentication — these figures include revenue and are not public.
tags:
- API Keys
security:
- apiKey: []
responses:
'200':
description: Statistics overview
content:
application/json:
schema:
$ref: '#/components/schemas/StatsOverview'
'403':
description: 'Authentication required — send Authorization: Bearer ifk_...'
/stats/history:
servers:
- url: https://api.ibanforge.com
description: Production
- url: http://localhost:3000
description: Local development
get:
operationId: getStatsHistory
summary: Historical statistics
description: Returns per-day statistics for the requested period. Requires authentication — these figures include revenue and are not public.
tags:
- API Keys
security:
- apiKey: []
parameters:
- name: period
in: query
required: false
description: Number of days to retrieve (1–90, default 7)
schema:
type: integer
minimum: 1
maximum: 90
default: 7
responses:
'200':
description: Historical stats array
content:
application/json:
schema:
type: array
items:
type: object
properties:
date:
type: string
format: date
total:
type: integer
revenue:
type: number
required:
- date
- total
- revenue
'403':
description: 'Authentication required — send Authorization: Bearer ifk_...'
components:
schemas:
StatsOverview:
type: object
required:
- total_operations
- by_type
- total_revenue_usdc
- top_countries
- last_7_days
properties:
total_operations:
type: integer
by_type:
type: object
properties:
iban_validate:
type: object
properties:
total:
type: integer
valid_count:
type: integer
success_rate:
type: number
iban_batch:
type: object
properties:
total:
type: integer
valid_count:
type: integer
success_rate:
type: number
bic_lookup:
type: object
properties:
total:
type: integer
found_count:
type: integer
hit_rate:
type: number
total_revenue_usdc:
type: number
deprecated: true
description: Deprecated alias for total_revenue_attempted_usdc. Use /admin/revenue for on-chain settled USDC.
total_revenue_attempted_usdc:
type: number
description: SUM of revenue_usdc in daily_stats. Reflects x402 calls that PASSED the payment middleware verify step, NOT a confirmation of on-chain settlement. For settled USDC see /admin/revenue.
revenue_note:
type: string
top_countries:
type: array
items:
type: object
properties:
country:
type: string
count:
type: integer
last_7_days:
type: array
items:
type: object
properties:
date:
type: string
format: date
total:
type: integer
revenue:
type: number
securitySchemes:
x402Payment:
type: apiKey
in: header
name: X-Payment
description: x402 USDC micropayment token
apiKey:
type: http
scheme: bearer
description: API key (Bearer ifk_xxx) — 200 free requests/month, or custom quota for paid keys
externalDocs:
description: Agent-oriented overview (llms.txt) with copy-paste examples
url: https://api.ibanforge.com/llms.txt
x-refined-from:
- ibanforge-api-keys-api-openapi.yml
- ibanforge-openapi.yml