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.
All 92 tools

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 email required.

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

OpenAPI Specification

ibanforge-api-keys-api-openapi.yml Raw ↑
openapi: 3.1.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:
    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
    servers:
    - url: https://api.ibanforge.com
      description: Production
    - url: http://localhost:3000
      description: Local development
  /v1/keys/usage:
    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
    servers:
    - url: https://api.ibanforge.com
      description: Production
    - url: http://localhost:3000
      description: Local development
  /stats:
    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_...'
    servers:
    - url: https://api.ibanforge.com
      description: Production
    - url: http://localhost:3000
      description: Local development
  /stats/history:
    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_...'
    servers:
    - url: https://api.ibanforge.com
      description: Production
    - url: http://localhost:3000
      description: Local development
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