# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for IBANforge Free API version: 1.0.0 extends: openapi/ibanforge-free-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 12 - target: $.paths['/v1/iban/format'].get update: x-apievangelist-phrasing: intent: Check an IBAN's format and checksum for free effect: read questions: - Is there a free way to check an IBAN's mod-97 checksum and length? - Does the free format check tell me if the bank code actually exists? - Can I pass an IBAN written in groups of four with spaces? instructions: - text: Check the format of IBAN {iban}. slots: iban: query.iban - text: Pre-filter {iban} for a malformed checksum or wrong length, no key needed. slots: iban: query.iban method: generated generated: '2026-09-26' - target: $.paths['/v1/ch/qr-bill/check'].post update: x-apievangelist-phrasing: intent: Check a Swiss QR-bill payload effect: read questions: - Does my Swiss QR-bill still use a combined (type K) address? - Can I verify the QR reference and QR-IBAN pairing in a QR-bill text? - Will my QR-bill stop working after the November 2026 cutoff? instructions: - text: 'Check this Swiss QR-bill payload: {payload}' slots: payload: requestBody.payload - text: Validate the QR-bill text {payload} and propose a structured address if needed. slots: payload: requestBody.payload method: generated generated: '2026-09-26' - target: $.paths['/v1/address/check'].post update: x-apievangelist-phrasing: intent: Check a postal address against ISO 20022 rules effect: read questions: - Is my structured postal address ready for the November 2026 ISO 20022 deadline? - Which payment schemes can a postal address be checked against? - Why is the cbpr+ scheme refused for address checks? instructions: - text: Check address {address} against the {scheme} rules. slots: scheme: requestBody.scheme address: requestBody.address - text: 'Validate this ISO 20022 PostalAddress for Fedwire: {address}; use scheme {scheme}.' slots: scheme: requestBody.scheme address: requestBody.address method: generated generated: '2026-09-26' - target: $.paths['/v1/reference/validate'].get update: x-apievangelist-phrasing: intent: Validate a structured payment reference effect: read questions: - Is this RF creditor reference checksum correct? - Which payment reference formats can be checked for free? - Why does a Norwegian KID come back as unverifiable? instructions: - text: Validate payment reference {reference}. slots: reference: query.reference - text: Check {reference} as a {reference_type} reference. slots: reference: query.reference reference_type: query.reference_type method: generated generated: '2026-09-26' - target: $.paths['/v1/reference/validate'].post update: x-apievangelist-phrasing: intent: Validate a payment reference sent as JSON effect: read questions: - Can I send a payment reference in a JSON body instead of the query string? - What if my reference has characters that are awkward to URL-encode? instructions: - text: Validate reference {reference} by posting it in a JSON body. slots: reference: requestBody.reference - text: Post {reference} as JSON and check it as type {reference_type}. slots: reference: requestBody.reference reference_type: requestBody.reference_type method: generated generated: '2026-09-26' - target: $.paths['/v1/iban/structure'].get update: x-apievangelist-phrasing: intent: List all supported IBAN countries effect: read questions: - Which countries use IBANs, and how long is each one? - Which IBAN countries are SEPA members? instructions: - text: List every supported IBAN country with its length. - text: Show all IBAN countries and whether they are in SEPA. method: generated generated: '2026-09-26' - target: $.paths['/v1/iban/structure/{country}'].get update: x-apievangelist-phrasing: intent: Get the IBAN format template for a country effect: read questions: - Where does the bank code sit inside a country's IBAN? - Can I get an example IBAN for a specific country to copy? - Is Verification of Payee mandatory in a given country? instructions: - text: Show the IBAN structure for {country}. slots: country: path.country - text: Give me the BBAN field positions and an example IBAN for {country}. slots: country: path.country method: generated generated: '2026-09-26' - target: $.paths['/v1/feedback'].post update: x-apievangelist-phrasing: intent: Report wrong data or claim an x402 refund effect: write questions: - How do I report a wrong or stale BIC answer? - Can I get a refund for a paid x402 call that answered wrongly? instructions: - text: Report that {endpoint} returned {got} instead of {expected}. slots: endpoint: requestBody.endpoint got: requestBody.got expected: requestBody.expected - text: Claim a refund for x402 transaction {tx_hash} on {endpoint}. slots: tx_hash: requestBody.tx_hash endpoint: requestBody.endpoint method: generated generated: '2026-09-26' - target: $.paths['/v1/feedback/{id}'].get update: x-apievangelist-phrasing: intent: Check the status of a feedback report effect: read questions: - Has my data error report been handled yet? - What details of a submitted report are public? instructions: - text: Check the status of feedback report {id}. slots: id: path.id - text: Tell me where report {id} stands. slots: id: path.id method: generated generated: '2026-09-26' - target: $.paths['/v1/test-iban'].get update: x-apievangelist-phrasing: intent: Generate test IBANs with real bank codes effect: read questions: - Where can I get test IBANs that use real registered bank codes? - Which countries can test IBANs be generated for? instructions: - text: Generate {count} test IBANs for {country}. slots: count: query.count country: query.country - text: Give me a test IBAN from a random supported country. method: generated generated: '2026-09-26' - target: $.paths['/v1/demo'].get update: x-apievangelist-phrasing: intent: See free demo validation results effect: read questions: - Can I see sample IBAN validation and compliance results without paying? - What does a validation answer look like on the official example IBANs? instructions: - text: Show me the free demo results. - text: Fetch the example validations, compliance check and BIC rows from the demo. method: generated generated: '2026-09-26' - target: $.paths['/health'].get update: x-apievangelist-phrasing: intent: Check API health and uptime effect: read questions: - Is the IBANforge API up right now? - What is the current uptime of the service? instructions: - text: Check the API health status. - text: Show the service uptime and basic stats. method: generated generated: '2026-09-26'