{ "item": [ { "id": "46d7c3ee-7712-4bb3-9456-c5cf9c87556c", "name": "Verification", "description": { "content": "Verification of Payee through the account's bank.", "type": "text/plain" }, "item": [ { "id": "c38e7b3f-4c79-416b-82be-5a69f3e9c651", "name": "Verify that a name matches the holder of an IBAN", "request": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "HTTP 200 · Name matches (recorded 8 Oct 2026)", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"query\": {\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\",\n \"success\": true\n },\n \"result\": {\n \"valid\": true,\n \"name_match\": \"yes\",\n \"bic\": \"BFSWDE33XXX\"\n },\n \"error\": \"\"\n}" }, { "name": "HTTP 200 · Close match (recorded 8 Oct 2026)", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"query\": {\n \"IBAN\": \"IT12T0623003204000030737371\",\n \"name\": \"Associazione della Croce Rossa Italiana – ODV\",\n \"success\": true\n },\n \"result\": {\n \"valid\": true,\n \"name_match\": \"partial\",\n \"bic\": \"CRPPIT2PXXX\"\n },\n \"error\": \"NAME_PARTIAL_MATCH\"\n}" }, { "name": "HTTP 200 · Wrong name for an existing account (recorded 8 Oct 2026)", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"query\": {\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"John Doe\",\n \"success\": true\n },\n \"result\": {\n \"valid\": false,\n \"name_match\": \"no\",\n \"bic\": \"BFSWDE33XXX\"\n },\n \"error\": \"NAME_NOT_MATCH\"\n}" }, { "name": "HTTP 200 · No verdict from the bank network (recorded 8 Oct 2026)", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"query\": {\n \"IBAN\": \"FR7630027174110002636660114\",\n \"name\": \"Fondation pour le Logement des Défavorisés\",\n \"success\": true\n },\n \"result\": {\n \"valid\": true,\n \"name_match\": \"unavailable\",\n \"bic\": \"CMCIFRPPXXX\"\n },\n \"error\": \"\"\n}" }, { "name": "HTTP 200 · Bank or account outside the VoP scheme (shape from the API source; not recorded on production)", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"query\": {\n \"IBAN\": \"NL91ABNA0417164300\",\n \"name\": \"John Doe\",\n \"success\": true\n },\n \"result\": {\n \"valid\": null,\n \"name_match\": \"unavailable\",\n \"bic\": \"ABNANL2AXXX\"\n },\n \"error\": \"VERIFICATION_NOT_SUPPORTED\"\n}" }, { "name": "HTTP 400 · checksum", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"error\": \"INVALID_IBAN_CHECKSUM\"\n}" }, { "name": "HTTP 401 · wrong_key", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"error\": \"INVALID_API_KEY\"\n}" }, { "name": "HTTP 405 · get", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 405, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"error\": \"METHOD_NOT_ALLOWED\"\n}" }, { "name": "HTTP 415 · form", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 415, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"error\": \"UNSUPPORTED_FORMAT\"\n}" }, { "name": "HTTP 500 · bank_not_found", "originalRequest": { "name": "Verify that a name matches the holder of an IBAN", "description": { "content": "The IBAN is cleaned (spaces and any other character that is not a letter or digit removed, letters\nupper-cased), its country and check digits are tested, the bank is identified and the request is sent\nto that bank. Supported countries: AT BE HR CY EE FI FR DE GR IE IT LV LT LU MT NL PT SK SI ES GB.\n", "type": "text/plain" }, "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [ "" ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": null, "body": { "mode": "raw", "raw": "{\n \"IBAN\": \"DE63370205000005023307\",\n \"name\": \"Deutsches Rotes Kreuz e.V\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json; charset=UTF-8" } ], "cookie": [], "body": "{\n \"error\": \"INTERNAL_SERVER_ERROR:BNFDBS\"\n}" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "https://api.iban.com/clients/api/verify/v3", "type": "string" }, { "key": "apiKey", "value": "", "type": "string" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] }, "info": { "_postman_id": "82d3f5d2-d154-452b-829f-f1836993ac14", "name": "BAV (VoP) API v3 — IBAN.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": "Generated from https://developer.iban.com/assets/openapi/bav-api-v3.yaml (OpenAPI 3.1). Fill the collection variable apiKey with your key from API Access; for the sandbox set baseUrl to https://sandbox.iban.com/clients/api/verify/v3 and apiKey to testkey." } }