theswiftcodes APItheswiftcodes.com ↗

"""Walkthrough: SWIFT Codes API — browse countries, look up codes, validate payments."""
from parse_apis.the_swift_codes_api import SwiftCodes, CountryIso, SwiftCodeNotFound

client = SwiftCodes()

# List available countries, take a few to show the catalog.
for country in client.countries.list(limit=3):
    print(country.name, country.slug)

# Construct a country by slug and browse its featured banks.
us = client.country("united-states")
for bank in us.banks.list(limit=3):
    print(bank.name, bank.slug)

# Get SWIFT codes for a bank, then inspect connection status.
bank = us.banks.list(limit=1).first()
if bank:
    for code in bank.swift_codes(limit=3):
        print(code.swift_code, code.bank_name, code.connection)

# Look up a specific SWIFT code's full details via the country sub-resource.
detail = us.swift_codes.get(swift_code="CHASUS33")
print(detail.bank_name, detail.address, detail.city, detail.postcode)

# Cascading search: find banks in a country using the CountryIso enum.
result = client.searchresults.search(country_iso=CountryIso.US, bank_name="Chase")
if result.cities:
    for entry in result.cities[:3]:
        print(entry.value)

# Validate a SWIFT code and print the outcome.
validation = client.swiftvalidations.validate(swift="CHASUS33")
print(validation.status, validation.bank, validation.swift_code_bic)

# Typed error handling: attempt to get a non-existent SWIFT code.
try:
    us.swift_codes.get(swift_code="XXXXXX99")
except SwiftCodeNotFound as exc:
    print(f"Not found: {exc.swift_code} in {exc.country_slug}")

print("exercised: countries.list / banks.list / bank.swift_codes / swift_codes.get / searchresults.search / swiftvalidations.validate")