{"uid":"cap_6RhW1pn7eWxrpWkwPOVOA","slug":"duo-data-utilities-iban-builder-7b243143","name":"Duo Data Utilities – IBAN Builder","description":"Construct an IBAN from a country code and the domestic account parts, computing the ISO 7064 mod-97-10 check digits. Takes either a single BBAN string or named parts (bank code, branch code, account number); digit fields are left-padded with zeros to the country's registered widths. Returns the IBAN in electronic and print formats with its bank, branch and account parts. Covers the 89 SWIFT registry countries. Named parts work only where they span the whole BBAN; otherwise pass the BBAN.","url":"https://api.duoleads.com/v1/id/iban-build?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"bank":{"type":"string","maxLength":16,"description":"Bank code. Requires account."},"bban":{"type":"string","maxLength":34,"description":"The whole domestic account number (BBAN), alphanumeric. Use this or bank plus account."},"branch":{"type":"string","maxLength":16,"description":"Branch code, for countries whose layout has a branch field."},"account":{"type":"string","maxLength":32,"description":"Account number. Requires bank."},"country":{"type":"string","maxLength":16,"description":"ISO 3166-1 alpha-2 country code in the SWIFT IBAN registry, case-insensitive."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","route","version","data","meta"],"properties":{"ok":{"const":true},"data":{"type":"object","required":["iban","iban_print","country","check_digits","bban","parts","length","valid"],"properties":{"bban":{"type":"string"},"iban":{"type":"string"},"parts":{"type":"object","required":["bank","branch","account"],"properties":{"bank":{"type":["string","null"]},"branch":{"type":["string","null"]},"account":{"type":["string","null"]}}},"valid":{"type":"boolean"},"length":{"type":"integer"},"country":{"type":"string"},"iban_print":{"type":"string"},"check_digits":{"type":"string"}}},"meta":{"type":"object","required":["request_id","computed_at","price_usd","deterministic","disclaimer"],"properties":{"sources":{"type":"array","items":{"type":"object","required":["id","version","published"]}},"price_usd":{"type":"string"},"disclaimer":{"type":"string"},"request_id":{"type":"string"},"computed_at":{"type":"string","description":"RFC 3339 UTC with milliseconds"},"deterministic":{"type":"boolean"}}},"route":{"const":"/v1/id/iban-build"},"version":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"data":{"bban":"ABNA0417164300","iban":"NL91ABNA0417164300","parts":{"bank":"ABNA","branch":null,"account":"0417164300"},"valid":true,"length":18,"country":"NL","iban_print":"NL91 ABNA 0417 1643 00","check_digits":"91"},"meta":{"sources":[{"id":"iban-registry","licence":"MIT","version":"ibantools 4.5.4, field layout schwifty 2026.7.3","published":"2026-04-10","attribution":"IBAN registry via ibantools (MIT); field offsets via schwifty (MIT); underlying data: SWIFT IBAN Registry, public"}],"price_usd":"0.05","disclaimer":"Factual output of a deterministic computation over public data. Provided as is, with no warranty of accuracy, completeness or availability. Not investment, financial, legal, tax, medical or any other professional advice, and not a recommendation. Verify before relying on it. Terms: https://api.duoleads.com/terms","request_id":"01K6B7Q4ZC8H3F2M9WXR5TYN0D","computed_at":"2026-09-28T12:00:00.000Z","deterministic":true},"route":"/v1/id/iban-build","version":"1.0.0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Xn7RZeT2epyOQ6NBVExTq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Constructs a valid IBAN from a country code and domestic account parts (BBAN or named bank/branch/account fields), computing ISO 7064 mod-97-10 check digits and returning both electronic and print formats.","exampleAgentPrompt":"Build me the IBAN for a Netherlands account with bank code ABNA and account number 0417164300 — give me both the electronic and printable formats.","exampleUseCases":[{"title":"Onboarding international bank account","prompt":"A user just entered their German bank details: bank code SSKM, branch code 70050000, and account number 1234567890 — can you build their IBAN for me so I can store it for SEPA transfers?"},{"title":"Validating payroll data before submission","prompt":"I have a UK account with sort code 200000 and account number 55779911 — construct the IBAN so I can include it in the payroll file before we send it."},{"title":"Generating IBAN from raw BBAN for French account","prompt":"I've got a French BBAN: 20041010050500013M02606 and the country code FR — can you build the full IBAN with check digits in both electronic and print format?"}],"resultDescription":"Returns a JSON object with the computed IBAN in electronic format (e.g. NL91ABNA0417164300) and print format (e.g. NL91 ABNA 0417 1643 00), plus the ISO 7064 check digits, the BBAN, structured parts (bank, branch, account), country code, IBAN length, and a validity boolean. Also includes metadata such as request ID, computation timestamp, data sources, and a disclaimer.","failureModes":["Missing required 'country' parameter returns an error","Invalid or unsupported country code (not in 89-country SWIFT registry) returns an error","Providing 'bank' without 'account' (or vice versa) returns a validation error","BBAN or named parts that don't match the country's registered field widths may produce an error or incorrect padding","Alphanumeric characters outside permitted IBAN character set return an error","Named parts (bank/branch/account) used for a country where they don't span the full BBAN return an error"],"whenToPreferThis":"Choose this endpoint when you need to programmatically construct a valid, standards-compliant IBAN from raw domestic account components and do not already have the IBAN string. It is especially useful for onboarding flows, payroll systems, or payment processors that collect local bank details and need to convert them to IBAN format for SEPA or international wire transfers. If you already have an IBAN string and only need to verify it, prefer the companion IBAN validation endpoint instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:31:11.398Z","isFirstParty":false,"canonicalSlug":"duo-data-utilities-iban-builder-7b243143"}