openapi: 3.1.0
info:
  title: ToadTec API
  version: '2026-10-18'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-18: 10 operation(s) read from 12 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; ToadTec has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 7
    pages-with-code: 10
    pages-read: 12
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-18'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.iban-test.eu/iban-validation-api
  - https://www.iban-test.eu/sepa-iban-validation-api
  - https://www.iban-test.eu/test-iban
  - https://www.iban-test.eu/API-Documentation
  - https://www.iban-test.eu/guides/iban-validation-php-form
  - https://www.iban-test.eu/guides/iban-validation-n8n
  - https://www.iban-test.eu/guides/check-sepa-bank-participation
  - https://www.iban-test.eu/FAQ/API
  - https://www.iban-test.eu/iban/ireland
  - https://www.iban-test.eu/iban/united-kingdom
  - https://www.iban-test.eu/iban/netherlands
  - https://www.iban-test.eu/iban/monaco
paths:
  /api/v2/iban/generate:
    get:
      operationId: get_api_v2_iban_generate
      tags:
      - Api
      summary: Generate an IBAN for Ireland
      description: The generator accepts up to 10 characters for bankcode and 8 characters for accountnumber, calculates the IBAN check digits
        and validates the result.
      x-source: https://www.iban-test.eu/iban/ireland
      parameters:
      - name: countrycode
        in: query
        required: true
        schema:
          type: string
        description: Country code, e.g. IE
      - name: bankcode
        in: query
        required: true
        schema:
          type: string
        description: Bank code up to 10 characters, e.g. AIBK931152
      - name: accountnumber
        in: query
        required: true
        schema:
          type: string
        description: Account number up to 8 characters, e.g. 12345678
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v2/iban/validate:
    get:
      operationId: get_api_v2_iban_validate
      tags:
      - Api
      summary: GET /api/v2/iban/validate
      x-source: https://www.iban-test.eu/iban-validation-api
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV2IbanValidateResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --get 'https://www.iban-test.eu/api/v2/iban/validate'  --header 'Authorization: Bearer YOUR_API_TOKEN'  --data-urlencode\
          \ 'iban=DE89370400440532013000' Example JSON response {\n \"error\": false,\n \"code\": 2100,\n \"details\": {\n \"bankName\": \"Commerzbank\"\
          ,\n \"bankCity\": \"Köln\",\n \"bic\": \"COBADEFFXXX\",\n \"sepa\": {\n \"sddCore\": {\n \"status\": \"confirmed\",\n \"reason\": \"\
          matched\"\n },\n \"sddB2b\": {\n \"status\": \"con"
    post:
      operationId: post_api_v2_iban_validate
      tags:
      - Api
      summary: POST /api/v2/iban/validate
      x-source: https://www.iban-test.eu/test-iban
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV2IbanValidateRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl --request POST ''https://www.iban-test.eu/api/v2/iban/validate''  --header ''Authorization: Bearer YOUR_API_TOKEN''  --header
          ''Content-Type: application/json''  --data ''{"iban":"GB29NWBK60161331926819"}'' For IBAN validation, 2100 indicates a valid result.
          A negative validation result such as 3100 can be returned with error: false . Evaluate the result code and handle authentication, quota
          and tech'
  /api/v2/iban/validate/DE89%203704%200044%200532%200130%2000:
    get:
      operationId: get_api_v2_iban_validate_DE89_203704_200044_200532_200130_2000
      tags:
      - Api
      summary: GET /api/v2/iban/validate/DE89%203704%200044%200532%200130%2000
      x-source: https://www.iban-test.eu/FAQ/API
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV2IbanValidateDe892037042000442005322001302000Response'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -H "Authorization: Bearer YOUR_API_TOKEN"  "https://www.iban-test.eu/api/v2/iban/validate/DE89%203704%200044%200532%200130%2000"
          Validate a BIC: GET /v2/bic/validate/{bic} curl -H "Authorization: Bearer YOUR_API_TOKEN"  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"
          Validate a bank account: GET /v2/bank-account/validate?bankcode=37040044&accountnumber=532013000 Generate an IBAN: G'
  /v2/bank-account/validate:
    get:
      operationId: get_v2_bank_account_validate
      tags:
      - Bank Account
      summary: IBAN Validation API Documentation
      x-source: https://www.iban-test.eu/API-Documentation
      parameters:
      - name: bankcode
        in: query
        required: true
        schema:
          type: string
        description: German bank code
      - name: accountnumber
        in: query
        required: true
        schema:
          type: string
        description: German account number
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2BankAccountValidateResponse'
      x-evidence:
        kind: documentation
  /v2/bic/validate/{bic}:
    get:
      operationId: get_v2_bic_validate_bic
      tags:
      - Bic
      summary: IBAN Validation API Documentation
      x-source: https://www.iban-test.eu/API-Documentation
      parameters:
      - name: bic
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2BicValidateBicResponse'
      x-evidence:
        kind: documentation
  /v2/iban/generate:
    get:
      operationId: get_v2_iban_generate
      tags:
      - Iban
      summary: IBAN Validation API Documentation
      x-source: https://www.iban-test.eu/API-Documentation
      parameters:
      - name: countrycode
        in: query
        required: true
        schema:
          type: string
        description: Country code for IBAN generation
      - name: bankcode
        in: query
        required: true
        schema:
          type: string
        description: Bank code for IBAN generation
      - name: accountnumber
        in: query
        required: true
        schema:
          type: string
        description: Account number for IBAN generation
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2IbanGenerateResponse'
      x-evidence:
        kind: documentation
  /v2/iban/validate:
    get:
      operationId: get_v2_iban_validate
      tags:
      - Iban
      summary: IBAN Validation API Documentation
      x-source: https://www.iban-test.eu/API-Documentation
      parameters:
      - name: iban
        in: query
        required: true
        schema:
          type: string
        description: IBAN to validate
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2IbanValidateResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_v2_iban_validate
      tags:
      - Iban
      summary: IBAN Validation API Documentation
      x-source: https://www.iban-test.eu/API-Documentation
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV2IbanValidateRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV2IbanValidateResponse'
      x-evidence:
        kind: documentation
  /v2/iban/validate/{iban}:
    get:
      operationId: get_v2_iban_validate_iban
      tags:
      - Iban
      summary: IBAN Validation API Documentation
      x-source: https://www.iban-test.eu/API-Documentation
      parameters:
      - name: iban
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV2IbanValidateIbanResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV2IbanValidateResponse:
      type: object
      properties:
        bankName:
          type: string
        bankCity:
          type: string
        bic:
          type: string
        sepa:
          type: object
          properties:
            sddCore:
              type: object
              properties:
                status:
                  type: string
                reason:
                  type: string
            sddB2b:
              type: object
              properties:
                status:
                  type: string
                reason:
                  type: string
    PostApiV2IbanValidateRequest:
      type: object
      properties:
        iban:
          type: string
    GetApiV2IbanValidateDe892037042000442005322001302000Response:
      type: object
      properties:
        error:
          type: boolean
        code:
          type: integer
        message:
          type: string
        details:
          type: object
    GetV2BankAccountValidateResponse:
      type: object
      properties:
        error:
          type: boolean
          description: Indicates if an error occurred
        code:
          type: integer
          description: Result code (e.g., 2300 for performed check)
        message:
          type: string
          description: Human‑readable message
        details:
          type: object
          description: Endpoint‑specific details (e.g., bank.valid, konto.valid)
    GetV2BicValidateBicResponse:
      type: object
      properties:
        error:
          type: boolean
          description: Indicates if an error occurred
        code:
          type: integer
          description: Result code (e.g., 2500 for valid BIC format)
        message:
          type: string
          description: Human‑readable message
        details:
          type: object
          description: Endpoint‑specific details
    GetV2IbanGenerateResponse:
      type: object
      properties:
        error:
          type: boolean
          description: Indicates if an error occurred
        code:
          type: integer
          description: Result code (e.g., 2200 for successful generation)
        message:
          type: string
          description: Human‑readable message
        details:
          type: object
          description: Generated IBAN and related details
    GetV2IbanValidateResponse:
      type: object
      properties:
        error:
          type: boolean
          description: Indicates if an error occurred
        code:
          type: integer
          description: Result code (e.g., 2100 for valid IBAN)
        message:
          type: string
          description: Human‑readable message
        details:
          type: object
          description: Endpoint‑specific details
    PostV2IbanValidateRequest:
      type: object
      properties:
        iban:
          type: string
          description: IBAN to validate (in request body)
      required:
      - iban
    PostV2IbanValidateResponse:
      type: object
      properties:
        error:
          type: boolean
          description: Indicates if an error occurred
        code:
          type: integer
          description: Result code (e.g., 2100 for valid IBAN)
        message:
          type: string
          description: Human‑readable message
        details:
          type: object
          description: Endpoint‑specific details
    GetV2IbanValidateIbanResponse:
      type: object
      properties:
        error:
          type: boolean
          description: Indicates if an error occurred
        code:
          type: integer
          description: Result code (e.g., 2100 for valid IBAN)
        message:
          type: string
          description: Human‑readable message
        details:
          type: object
          description: Endpoint‑specific details
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Bank Account
- name: Bic
- name: Iban