Enrich
POST /v1/enrich — batch-check IBANs, BICs, currency codes and ISO 20022 external codes against registry data; get validity, normalized forms and derived facts.
What it checks
POST /v1/enrich validates financial identifiers against free, redistributable registry data:
- IBANs — structure, length per country, check digits; derives the country and normalized form
- BICs — structure and known-directory checks
- Currency codes — ISO 4217
- ISO 20022 external codes — purpose codes, bank transaction codes
curl -sS -X POST https://api.transmute.403fin.io/v1/enrich \
-H "Authorization: Bearer $TRANSMUTE_KEY" \
-H "Content-Type: application/json" \
-d '{
"items": [
{"type": "iban", "value": "DE89370400440532013000"},
{"type": "bic", "value": "AAAADEFF"}
]
}'
Each item comes back with validity, the normalized form, derived facts, and findings for anything questionable.
Privacy
Enrich inputs are identifiers, not message bodies — but IBANs are personal data, so the same discipline applies unchanged: values are never logged or persisted, error details reference item indexes rather than values, and the usage record carries counts and status only.
Access
Requires the enrich scope (granted by default on new keys). Enrich is one of the four metered routes — the billing rules and quota headers apply.