{"openapi":"3.1.0","info":{"title":"Bank Account Identifiers & Payment Files API","version":"1.0.0","description":"UK Vocalink modulus checks, SEPA creditor ID and IBAN-from-BBAN helpers, UETR validation, CBPR+ postal address checks, NACHA ACH file build/validate, and camt.052/053/054 statement parsing — pure compute or vendored Vocalink tables. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/bank-payments/uk-modulus-check":{"post":{"operationId":"uk_sort_code_account_modulus_check","summary":"UK sort code + account modulus check","description":"Check whether a UK sort code and account number pair can be valid using Vocalink modulus weights (valacdos/scsubtab) and exceptions 1–14.","tags":["bank-payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sortCode":{"type":"string","minLength":6,"maxLength":12},"accountNumber":{"type":"string","minLength":6,"maxLength":14}},"required":["sortCode","accountNumber"],"additionalProperties":false},"example":{"sortCode":"089999","accountNumber":"66374958"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"sortCode":{"type":"string"},"accountNumber":{"type":"string"},"standardisedAccountNumber":{"type":"string"},"standardisedSortCode":{"type":"string"},"checksAvailable":{"type":"boolean"},"checks":{"type":"array","items":{"type":"object","properties":{"algorithm":{"type":"string"},"weights":{"type":"array","items":{"type":"number"}},"exception":{"type":"null"},"total":{"type":"number"},"passed":{"type":"boolean"}},"additionalProperties":true}},"valid":{"type":"boolean"},"result":{"type":"string"},"specVersion":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"sortCode":"089999","accountNumber":"66374958","standardisedAccountNumber":"66374958","standardisedSortCode":"089999","checksAvailable":true,"checks":[{"algorithm":"MOD10","weights":[0,0,"…"],"exception":null,"total":180,"passed":true}],"valid":true,"result":"valid","specVersion":"9.20","sources":[{"source":"Vocalink UK modulus checking v9.20 (valacdos.txt, scsubtab.txt)","url":"https://www.vocalink.com/tools/modulus-checking/","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["A pass means the pair can be valid. It does not prove the account exists or is open.","Sort codes not in the weight table cannot be checked and are presumed valid (spec 2.2.1 step 1).","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/bank-payments/sepa-creditor-id-validate":{"post":{"operationId":"validate_a_sepa_creditor_identifier","summary":"Validate a SEPA Creditor Identifier","description":"Parse a SEPA Direct Debit Creditor Identifier and recompute ISO 7064 Mod 97-10 check digits (business code excluded).","tags":["bank-payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"creditorId":{"type":"string","minLength":8,"maxLength":40}},"required":["creditorId"],"additionalProperties":false},"example":{"creditorId":"DE98ZZZ09999999999"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"creditorId":{"type":"string"},"country":{"type":"string"},"checkDigits":{"type":"string"},"expectedCheckDigits":{"type":"string"},"businessCode":{"type":"string"},"nationalIdentifier":{"type":"string"},"valid":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"creditorId":"DE98ZZZ09999999999","country":"DE","checkDigits":"98","expectedCheckDigits":"98","businessCode":"ZZZ","nationalIdentifier":"09999999999","valid":true,"sources":[{"source":"EPC262-08 Creditor Identifier Overview v12.0 (algorithm only)","url":"https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/creditor-identifier-overview","retrievedAt":"2025-10-05","status":"ok"}],"limitations":["Format and check digits only; does not confirm the CI was issued.","Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/bank-payments/iban-from-bban":{"post":{"operationId":"build_an_iban_from_a_bban","summary":"Build an IBAN from a BBAN","description":"Compute ISO 13616 check digits for a country code and domestic BBAN, then validate the resulting IBAN structure.","tags":["bank-payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"country":{"type":"string","pattern":"^[A-Za-z]{2}$"},"bban":{"type":"string","minLength":1,"maxLength":34}},"required":["country","bban"],"additionalProperties":false},"example":{"country":"GB","bban":"NWBK60161331926819"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"iban":{"type":"string"},"ibanPrint":{"type":"string"},"checkDigits":{"type":"string"},"valid":{"type":"boolean"},"expectedBbanLength":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"iban":"GB29NWBK60161331926819","ibanPrint":"GB29 NWBK 6016 1331 9268 19","checkDigits":"29","valid":true,"expectedBbanLength":18,"sources":[{"source":"SWIFT IBAN Registry lengths + ISO 13616 mod-97","url":"https://www.swift.com/standards/data-standards/iban","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Builds check digits only. Does not validate national account check digits or confirm the account exists.","Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/bank-payments/uetr-validate":{"post":{"operationId":"validate_or_generate_a_uetr","summary":"Validate or generate a UETR","description":"Validate an ISO 20022 UETR as a UUID version 4, or generate one or more UETRs with crypto.randomUUID().","tags":["bank-payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"uetr":{"type":"string","minLength":1,"maxLength":64},"generate":{"type":"boolean"},"count":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false},"example":{"uetr":"eb6305c9-1f7f-49de-aed0-16487c27b42d"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"uetr":{"type":"string"},"valid":{"type":"boolean"},"version":{"type":"number"},"variant":{"type":"string"},"normalised":{"type":"string"},"reason":{"type":"null"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"uetr":"eb6305c9-1f7f-49de-aed0-16487c27b42d","valid":true,"version":4,"variant":"RFC4122","normalised":"eb6305c9-1f7f-49de-aed0-16487c27b42d","reason":null,"sources":[{"source":"ISO 20022 UUIDv4Identifier / RFC 9562 UUID version 4","url":"https://www.rfc-editor.org/rfc/rfc9562","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["ISO 20022 UETR values are UUID version 4; other UUID versions are rejected.","Pattern matching is case-insensitive; normalised output is lower-case for ISO 20022 pattern compatibility.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/bank-payments/postal-address-check":{"post":{"operationId":"cbpr_postal_address_format_check","summary":"CBPR+ postal address format check","description":"Classify an ISO 20022 PostalAddress as structured, hybrid or unstructured and check Swift CBPR+ town/country/AdrLine rules.","tags":["bank-payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"address":{"type":"object","properties":{"Dept":{"type":"string","maxLength":70},"SubDept":{"type":"string","maxLength":70},"StrtNm":{"type":"string","maxLength":70},"BldgNb":{"type":"string","maxLength":16},"BldgNm":{"type":"string","maxLength":35},"Flr":{"type":"string","maxLength":70},"PstBx":{"type":"string","maxLength":16},"Room":{"type":"string","maxLength":70},"PstCd":{"type":"string","maxLength":16},"TwnNm":{"type":"string","maxLength":35},"TwnLctnNm":{"type":"string","maxLength":35},"DstrctNm":{"type":"string","maxLength":35},"CtrySubDvsn":{"type":"string","maxLength":35},"Ctry":{"type":"string","pattern":"^[A-Za-z]{2}$"},"AdrLine":{"maxItems":7,"type":"array","items":{"type":"string","maxLength":70}}},"additionalProperties":false},"role":{"default":"party","type":"string","enum":["party","agent"]},"agentHasBic":{"type":"boolean"},"messageType":{"type":"string","minLength":1,"maxLength":32}},"required":["address"],"additionalProperties":false},"example":{"address":{"StrtNm":"MARK LANE","BldgNb":"55","BldgNm":"THE CORN EXCHANGE","Flr":"6","PstCd":"EC3R 7NE","TwnNm":"LONDON","Ctry":"GB","AdrLine":[]},"role":"party","messageType":"pacs.008"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":"string"},"cbprCompliant":{"type":"boolean"},"issues":{"type":"array","items":{}},"exempt":{"type":"boolean"},"cbprRetirementDate":{"type":"null"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"format":"structured","cbprCompliant":true,"issues":[],"exempt":false,"cbprRetirementDate":null,"sources":[{"source":"Swift ISO 20022 unstructured address removal / CBPR+ postal address rules","url":"https://www.swift.com/standards/iso-20022/removal-unstructured-address","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["cbprRetirementDate is null because Swift deferred the original 14 Nov 2026 retirement; the revised timeline is pending.","Free-text AdrLine values are not parsed into structured fields.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/bank-payments/nacha-file-build":{"post":{"operationId":"build_a_nacha_ach_file","summary":"Build a NACHA ACH file","description":"Generate a 94-character NACHA ACH file (PPD/CCD/WEB/TEL) with batch hashes, totals and blocking-factor padding from JSON entries.","tags":["bank-payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"immediateDestination":{"type":"string","minLength":9,"maxLength":10},"immediateOrigin":{"type":"string","minLength":9,"maxLength":10},"destinationName":{"type":"string","minLength":1,"maxLength":23},"originName":{"type":"string","minLength":1,"maxLength":23},"fileCreationDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"fileCreationTime":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"fileIdModifier":{"default":"A","type":"string","pattern":"^[A-Z0-9]$"},"batches":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"companyName":{"type":"string","minLength":1,"maxLength":16},"companyId":{"type":"string","minLength":1,"maxLength":10},"secCode":{"type":"string","enum":["PPD","CCD","WEB","TEL"]},"entryDescription":{"type":"string","minLength":1,"maxLength":10},"effectiveEntryDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"odfiRouting":{"type":"string","pattern":"^\\d{8}$"},"companyDiscretionaryData":{"type":"string","maxLength":20},"descriptiveDate":{"type":"string","maxLength":6},"entries":{"minItems":1,"maxItems":100000,"type":"array","items":{"type":"object","properties":{"transactionCode":{"type":"string","enum":["22","23","27","28","32","33","37","38"]},"rdfiRouting":{"type":"string","minLength":8,"maxLength":12},"accountNumber":{"type":"string","minLength":1,"maxLength":17},"amount":{"type":"integer","minimum":0,"maximum":9999999999},"individualId":{"type":"string","minLength":1,"maxLength":15},"name":{"type":"string","minLength":1,"maxLength":22},"paymentTypeCode":{"type":"string","enum":["R","S"]},"addenda":{"type":"string","maxLength":80}},"required":["transactionCode","rdfiRouting","accountNumber","amount","individualId","name"],"additionalProperties":false}}},"required":["companyName","companyId","secCode","entryDescription","effectiveEntryDate","odfiRouting","entries"],"additionalProperties":false}}},"required":["immediateDestination","immediateOrigin","destinationName","originName","fileCreationDate","fileCreationTime","batches"],"additionalProperties":false},"example":{"immediateDestination":"021000021","immediateOrigin":"1234567890","destinationName":"JPMORGAN CHASE","originName":"ACME CORP","fileCreationDate":"2026-11-16","fileCreationTime":"09:00","fileIdModifier":"A","batches":[{"companyName":"ACME CORP","companyId":"1234567890","secCode":"PPD","entryDescription":"PAYROLL","effectiveEntryDate":"2026-11-17","odfiRouting":"02100002","entries":[{"transactionCode":"22","rdfiRouting":"021000021","accountNumber":"123456789","amount":150000,"individualId":"EMP001","name":"JANE DOE"},{"transactionCode":"27","rdfiRouting":"011000015","accountNumber":"987654321","amount":2500,"individualId":"INV42","name":"JOHN ROE"}]}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"file":{"type":"string"},"lineCount":{"type":"number"},"batchCount":{"type":"number"},"entryAddendaCount":{"type":"number"},"entryHash":{"type":"string"},"totalDebit":{"type":"number"},"totalCredit":{"type":"number"},"serviceClassCodes":{"type":"array","items":{"type":"string"}},"warnings":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"file":"101 02100002112345678902611160900A094101JPMORGAN CHASE         ACME CORP                      \n5200ACME CORP           …","lineCount":10,"batchCount":1,"entryAddendaCount":2,"entryHash":"0003200003","totalDebit":2500,"totalCredit":150000,"serviceClassCodes":["200"],"warnings":[],"sources":[{"source":"Nacha ACH Guide for Developers","url":"https://achdevguide.nacha.org/ach-file-overview","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Generated from the Nacha ACH Guide for Developers; your ODFI may require different File Header values.","Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/bank-payments/nacha-file-validate":{"post":{"operationId":"validate_a_nacha_ach_file","summary":"Validate a NACHA ACH file","description":"Validate NACHA record order, lengths, ABA checksums, batch/file hashes and totals, reporting every structural error by line.","tags":["bank-payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"file":{"type":"string","minLength":94,"maxLength":5000000},"maxErrors":{"default":200,"type":"integer","minimum":1,"maximum":1000}},"required":["file"],"additionalProperties":false},"example":{"file":"101 02100002112345678902611160900A094101JPMORGAN CHASE         ACME CORP                      \n5200ACME CORP                           1234567890PPDPAYROLL         261117   1021000020000001"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"valid":{"type":"boolean"},"summary":{"type":"object","properties":{"lines":{"type":"number"},"batches":{"type":"number"},"entries":{"type":"number"},"totalDebit":{"type":"number"},"totalCredit":{"type":"number"}},"additionalProperties":true},"errors":{"type":"array","items":{}},"warnings":{"type":"array","items":{}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"valid":true,"summary":{"lines":10,"batches":1,"entries":2,"totalDebit":2500,"totalCredit":150000},"errors":[],"warnings":[],"sources":[{"source":"Nacha ACH Guide for Developers","url":"https://achdevguide.nacha.org/ach-file-overview","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Structural and checksum validation only; ODFI acceptance rules are not applied.","Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/bank-payments/camt053-parse":{"post":{"operationId":"parse_camt_052_053_054_statements","summary":"Parse camt.052/053/054 statements","description":"Parse an ISO 20022 bank-to-customer statement or report into normalised JSON with balance reconciliation checks.","tags":["bank-payments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"xml":{"type":"string","minLength":20,"maxLength":10000000},"includeRaw":{"default":false,"type":"boolean"}},"required":["xml"],"additionalProperties":false},"example":{"xml":"<Document xmlns=\"urn:iso:std:iso:20022:tech:xsd:camt.053.001.08\">...</Document>","includeRaw":false}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"messageType":{"type":"string"},"statements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string"},"account":{"type":"object","properties":{"iban":{"type":"string"},"currency":{"type":"string"}},"additionalProperties":true},"balances":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"amount":{"type":"string"},"currency":{"type":"string"},"creditDebit":{"type":"string"},"date":{"type":"string"}},"additionalProperties":true}},"entries":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"string"},"currency":{"type":"string"},"creditDebit":{"type":"string"},"status":{"type":"string"},"bookingDate":{"type":"string"},"valueDate":{"type":"string"},"accountServicerRef":{"type":"string"},"bankTxCode":{"type":"object","properties":{"domain":{"type":"string"},"family":{"type":"string"},"subFamily":{"type":"string"}},"additionalProperties":true},"endToEndId":{"type":"string"},"remittance":{"type":"array","items":{"type":"string"}},"counterparty":{"type":"object","properties":{"name":{"type":"string"},"iban":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}},"balanceReconciles":{"type":"boolean"}},"additionalProperties":true}},"checks":{"type":"object","properties":{"balanceReconciles":{"type":"boolean"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"messageType":"camt.053.001.08","statements":[{"id":"STMT-1","createdAt":"2026-11-13T18:00:00Z","account":{"iban":"DE89370400440532013000","currency":"EUR"},"balances":[{"type":"OPBD","amount":"1000.00","currency":"EUR","creditDebit":"CRDT","date":"2026-11-13"},{"type":"CLBD","amount":"1100.00","currency":"EUR","creditDebit":"CRDT","date":"2026-11-13"}],"entries":[{"amount":"100.00","currency":"EUR","creditDebit":"CRDT","status":"BOOK","bookingDate":"2026-11-13","valueDate":"2026-11-13","accountServicerRef":"REF1","bankTxCode":{"domain":"PMNT","family":"RCDT","subFamily":"ESCT"},"endToEndId":"E2E-1","remittance":["INV 123"],"counterparty":{"name":"ACME GMBH","iban":"DE44500105175407324931"}}],"balanceReconciles":true}],"checks":{"balanceReconciles":true},"sources":[{"source":"ISO 20022 camt.052/053/054 message definitions","url":"https://www.iso20022.org/iso-20022-message-definitions","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Parses common element paths only; no XSD validation is performed in this endpoint.","Amounts remain decimal strings; they are never converted to floating-point numbers.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}