theswiftcodes.com APItheswiftcodes.com ↗
Look up and validate SWIFT/BIC codes, IBANs, and US routing numbers across 205+ countries. Search banks by country, city, or institution name.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ab1745a7-aa6a-45d7-bfcb-90aafaefec26/get_all_countries' \ -H 'X-API-Key: $PARSE_API_KEY'
Get list of all countries with their slugs and URLs. Returns approximately 205 countries available on the site.
No input parameters required.
{
"type": "array",
"fields": {
"url": "full URL to the country page",
"name": "country name",
"slug": "URL slug used as country_slug in other endpoints"
},
"sample": {
"data": [
{
"url": "https://www.theswiftcodes.com/albania/",
"name": "ALBANIA",
"slug": "albania"
},
{
"url": "https://www.theswiftcodes.com/algeria/",
"name": "ALGERIA",
"slug": "algeria"
}
],
"status": "success"
}
}About the theswiftcodes.com API
This API exposes 9 endpoints covering SWIFT/BIC code lookup, IBAN validation, and US routing number verification sourced from theswiftcodes.com, which indexes data across approximately 205 countries. The get_swift_codes_by_country endpoint returns paginated bank records including swift_code, bank, city, and branch, while validate_swift_code and validate_iban return structured validation status alongside bank name, address, and checksum details.
SWIFT Code Lookup and Search
The get_all_countries endpoint returns a list of ~205 countries, each with a slug field used as the country_slug parameter in downstream calls. get_swift_codes_by_country accepts that slug plus an optional page integer and returns up to 50 SWIFT code entries per page with total_pages metadata for iteration. For targeted lookups, get_swift_code_details accepts a specific swift_code and country_slug and returns bank_name, address, city, postcode, branch, and a connection field indicating Active or Passive status.
Search by Bank or City
search_swift_codes implements a cascading search over three parameters: country_iso (required, two-letter ISO code), bank_name (optional), and city_name (optional). Supplying only country_iso returns an array of banks. Adding bank_name returns matching cities. Including all three parameters returns an array of swift_codes. The get_featured_banks_by_country endpoint surfaces a curated list of prominent banks per country, returning a slug value usable in get_swift_codes_by_bank, which paginates all SWIFT codes for that institution including address, postcode, and connection status.
Validation Endpoints
validate_swift_code accepts a single swift string and returns a status of Valid or Invalid, the bank name, address, and a human-readable message. validate_iban returns status, country, checksum, bban, and account_number extracted from the IBAN. validate_routing_number is US-specific and returns bank, address, city, state, zip, and phone for recognized routing numbers. All three validation endpoints return an empty object when the input is not recognized.
- Verify a SWIFT/BIC code before initiating an international wire transfer, using
validate_swift_codeto confirm bank name and active status. - Build a bank directory for a fintech app by paginating
get_swift_codes_by_countryacross all 205 countries. - Validate IBANs in a payment form using
validate_ibanto extractaccount_number,checksum, and country before submission. - Check US ACH routing numbers in a payment flow with
validate_routing_numberto surface bank name and address for user confirmation. - Power a bank autocomplete widget using
search_swift_codescascading through country, bank name, and city inputs. - Enumerate branch-level SWIFT codes for a specific institution with
get_swift_codes_by_bankusing abank_slugfromget_featured_banks_by_country. - Audit a dataset of international payment records by bulk-validating SWIFT codes and flagging any that return a Passive
connectionstatus.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does theswiftcodes.com have an official developer API?+
What does the `connection` field in SWIFT code details mean?+
connection field returned by get_swift_code_details and get_swift_codes_by_bank indicates whether the SWIFT participant is Active or Passive. An Active connection means the bank is a live SWIFT member; Passive generally means the code exists in the directory but the institution does not receive live SWIFT messages directly.Does `search_swift_codes` require all three parameters?+
country_iso is required. Providing just country_iso returns a list of banks. Adding bank_name returns cities for that bank in the country. Only when country_iso, bank_name, and city_name are all provided does the response include the swift_codes array.Does the API cover historical or deregistered SWIFT codes?+
Is IBAN validation available for all countries, or only specific regions?+
validate_iban accepts IBAN strings for any country that uses the IBAN standard and is represented in the site's data. Coverage aligns with the ~205 countries indexed. Routing number validation via validate_routing_number is US-only. Coverage for non-IBAN payment identifiers such as sort codes or BSB numbers is not currently part of the API. You can fork it on Parse and revise to add endpoints for those identifier types.