HelpMyAgent Iban API

Iban

GitHub OpenAPI

Operations 1

POST /v1/iban/validate IBAN Structure Validation #

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/helpmyagent-com:helpmyagent-com-iban-api"
All apis
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.

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

helpmyagent-com-iban-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HelpMyAgent Iban API
  version: v1
  description: Pay-per-call APIs designed to be discovered and consumed by AI agents.
  x-guidance: HelpMyAgent exposes pay-per-call APIs. Choose an operation by its documented purpose, coverage and use_when guidance when available. Use the declared input schema and method. Each paid operation declares its decimal USD price in x-payment-info. An unpaid call returns HTTP 402 with x402 v2 payment requirements; submit a valid payment and retry the same request to receive the business JSON result. Do not use an endpoint outside its declared geographic coverage or documented use case.
  contact:
    url: https://helpmyagent.com
    email: hi@helpmyagent.com
servers:
- url: https://api.helpmyagent.com
  description: HelpMyAgent public API gateway
tags:
- name: IBAN
  description: Iban
paths:
  /v1/iban/validate:
    post:
      tags:
      - IBAN
      summary: IBAN Structure Validation
      description: Validates IBAN structure and mod-97 checksum locally and extracts French bank/branch/account components when present.
      operationId: v1IbanValidate
      externalDocs:
        description: HelpMyAgent endpoint documentation
        url: https://helpmyagent.com/en/apis/iban/validate
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  iban:
                    type: string
                    description: Structured value returned for “iban” as defined by this API contract.
                  country_code:
                    type: string
                    description: Structured value returned for “country code” as defined by this API contract.
                  structure_valid:
                    type: boolean
                    description: Structured value returned for “structure valid” as defined by this API contract.
                  checksum_valid:
                    type: boolean
                    description: Structured value returned for “checksum valid” as defined by this API contract.
                  valid:
                    type: boolean
                    description: Whether the supplied identifier passed the endpoint’s validation rules.
                  expected_length:
                    type:
                    - integer
                    - 'null'
                    description: Structured value returned for “expected length” as defined by this API contract.
                  bank_code:
                    type:
                    - string
                    - 'null'
                    description: Structured value returned for “bank code” as defined by this API contract.
                  branch_code:
                    type:
                    - string
                    - 'null'
                    description: Structured value returned for “branch code” as defined by this API contract.
                  account_number:
                    type:
                    - string
                    - 'null'
                    description: Structured value returned for “account number” as defined by this API contract.
                  rib_key:
                    type:
                    - string
                    - 'null'
                    description: Structured value returned for “rib key” as defined by this API contract.
                  bic:
                    type:
                    - string
                    - 'null'
                    description: Structured value returned for “bic” as defined by this API contract.
                  bank_name:
                    type:
                    - string
                    - 'null'
                    description: Structured value returned for “bank name” as defined by this API contract.
                  checked_at:
                    type: string
                    description: UTC timestamp at which HelpMyAgent performed the check.
                  limitations:
                    type: array
                    items:
                      type: string
                    description: Known interpretation, source-coverage or freshness limitations for this result.
                additionalProperties: false
                required:
                - iban
                - country_code
                - structure_valid
                - checksum_valid
                - valid
                - expected_length
                - bank_code
                - branch_code
                - account_number
                - rib_key
                - bic
                - bank_name
                - checked_at
                description: Structured result returned by the iban/validate API.
              example:
                iban: FR1420041010050500013M02606
                country_code: FR
                structure_valid: true
                checksum_valid: true
                valid: true
                expected_length: 27
                bank_code: '20041'
                branch_code: '01005'
                account_number: 0500013M026
                rib_key: '06'
                bic: null
                bank_name: null
                checked_at: '2026-09-07T16:50:13+02:00'
                limitations:
                - La validation confirme la structure et la clé de contrôle ; elle ne prouve pas que le compte existe ou appartient au bénéficiaire.
                - L’identification publique gratuite de la banque n’est pas garantie pour tous les pays ; bank_name et bic peuvent être nuls.
        '402':
          description: Payment required when payment is enabled for the endpoint.
        4XX:
          description: Client request error.
        5XX:
          description: Server or upstream provider error.
      x-helpmyagent-pricing:
        mode: fixed
        price: '0.002'
        currency: USD
        billingPolicy:
          charge_on: valid_result
          no_charge_on_empty_result: true
          no_charge_on_error: true
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
        accepts:
        - scheme: exact
          network: eip155:8453
          amount: '2000'
          asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          payTo: '0xEaB9543AcF710a24fe096913A428E7d066c88F59'
          maxTimeoutSeconds: 60
          extra:
            assetTransferMethod: eip3009
            name: USD Coin
            version: '2'
        - scheme: exact
          network: xrpl:0
          amount: '0.002'
          asset: 524C555344000000000000000000000000000000
          payTo: rUXKCZetEbwQc1i5vkJL6SNXYK3hG7Fezy
          maxTimeoutSeconds: 600
          extra:
            sourceTag: 804681468
            issuer: rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De
      x-helpmyagent-coverage:
        countries:
        - EU
        - GB
        - CH
        - 'NO'
        - IS
        - LI
        - MC
        - AD
      x-helpmyagent-use-when:
      - Validate an IBAN checksum before using it in a workflow.
      - You need local IBAN normalization, structural validation and mod-97 checksum verification before using an account identifier.
      - For French IBANs, you also want the available bank, branch, account and RIB-key components.
      x-helpmyagent-avoid-when:
      - You need to verify that an IBAN belongs to a specific supplier; structural validation cannot establish ownership.
      - You need supplier-level public identity/compliance context; use company/fr/supplier-verification.
      x-helpmyagent-limitations:
      - A checksum-valid IBAN can still refer to a closed, nonexistent or unrelated bank account.
      - Bank/BIC enrichment is returned only when supported by the endpoint’s available reference data.
      x-helpmyagent-example-queries:
      - Validate an IBAN checksum before using it in a workflow.
      x-helpmyagent-sources:
      - code: iso-13616
        name: ISO 13616 checksum validation
        url: https://www.iso.org/standard/81090.html
      x-helpmyagent-freshness:
        mode: source_dependent
      x-helpmyagent-mcp-annotations:
        readOnlyHint: false
        destructiveHint: false
        idempotentHint: false
        openWorldHint: false
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                iban:
                  type: string
                  minLength: 15
                  maxLength: 34
                  description: IBAN to normalize and validate structurally, including the ISO 13616 mod-97 checksum. (minimum length 15; maximum length 34).
              additionalProperties: false
              required:
              - iban
              description: Structured input parameters for the iban/validate API.
            example:
              iban: FR1420041010050500013M02606
      x-helpmyagent-demo:
        url: https://api.helpmyagent.com/demo/iban/validate
        isSnapshot: true
        generatedAt: '2026-09-07T14:50:13+00:00'
        sourceAsOf: null
x-helpmyagent-discovery:
  llms: https://helpmyagent.com/llms.txt
  openapi: https://api.helpmyagent.com/openapi.json
  capabilities: https://helpmyagent.com/capabilities.json
  mcp: https://helpmyagent.com/mcp
  api_catalog: https://helpmyagent.com/.well-known/api-catalog
  pricing: https://helpmyagent.com/pricing.json
  x402: https://helpmyagent.com/.well-known/x402
  x402_service: https://helpmyagent.com/.well-known/x402-service.json
  health: https://helpmyagent.com/health