# Theswiftcodes — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Validate and look up SWIFT codes, IBANs, and US routing numbers across banks and countries worldwide. Search for banking details by country or institution, and verify the accuracy of international payment identifiers in real-time.

**Category:** Finance & Markets | **Website:** [theswiftcodes.com/](https://theswiftcodes.com/) | **Docs:** [parse.bot/marketplace/ac6a3ab7-64e3-45fd-bb56-a0bc0dfe9b34/theswiftcodes-com-api](https://parse.bot/marketplace/ac6a3ab7-64e3-45fd-bb56-a0bc0dfe9b34/theswiftcodes-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_countries

Get list of all countries with their slugs. Returns approximately 205 countries available on the site. Each country slug can be used to browse SWIFT codes or featured banks for that country.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/get_all_countries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_featured_banks_by_country

Get list of featured/popular banks for a specific country. Returns bank names with slugs that can be used in get_swift_codes_by_bank. Typically returns 5-15 major banks per country. Not all countries have featured banks listed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_slug` | string | Yes | Country slug from get_all_countries (e.g. 'united-states', 'united-kingdom', 'germany'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/get_featured_banks_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_slug":"<string>"}'
```

### get_swift_code_details

Get detailed information for a specific SWIFT code in a country. Returns bank name, address, city, connection status, and other details. The swift_code parameter is case-insensitive.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_slug` | string | Yes | Country slug from get_all_countries (e.g. 'united-states'). |
| `swift_code` | string | Yes | SWIFT/BIC code (e.g. 'CHASUS33', 'BARCGB22'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/get_swift_code_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_slug":"<string>","swift_code":"<string>"}'
```

### get_swift_codes_by_bank

Get all SWIFT codes associated with a specific bank in a country. Returns paginated results with bank details including address, city, and connection status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bank_slug` | string | Yes | Bank slug from get_featured_banks_by_country (e.g. 'chase', 'bank-of-america'). |
| `country_slug` | string | Yes | Country slug from get_all_countries (e.g. 'united-states'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/get_swift_codes_by_bank \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bank_slug":"<string>","country_slug":"<string>","page":"<integer>"}'
```

### get_swift_codes_by_country

Get paginated list of SWIFT codes for a specific country. Returns up to 50 items per page with pagination metadata. Each item includes bank name, city, branch, and the SWIFT code itself.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_slug` | string | Yes | Country slug from get_all_countries (e.g. 'united-states', 'germany', 'united-kingdom'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/get_swift_codes_by_country \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_slug":"<string>","page":"<integer>"}'
```

### search_swift_codes

Search for SWIFT codes using cascading search (Country -> Bank -> City). With country_iso only, returns list of banks. With country_iso + bank_name, returns list of cities for the matched bank. With all three parameters, returns matching SWIFT codes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bank_name` | string | No | Bank name or partial name to search for. Matched against available banks in the country. |
| `city_name` | string | No | City name to filter results. Requires bank_name to be provided. |
| `country_iso` | string | Yes | Two-letter country ISO code (e.g. 'US', 'GB', 'DE'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/search_swift_codes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bank_name":"<string>","city_name":"<string>","country_iso":"<string>"}'
```

### validate_iban

Validate an IBAN number and retrieve associated details. Returns validation status, country, checksum, and account details for valid IBANs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `iban` | string | Yes | IBAN number to validate (e.g. 'DE89370400440532013000', 'GB29NWBK60161331926819'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/validate_iban \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"iban":"<string>"}'
```

### validate_routing_number

Validate a US routing number and retrieve bank information. Returns bank name, address, and contact details for valid routing numbers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `routing` | string | Yes | US routing number to validate (e.g. '021000021', '011000138'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/validate_routing_number \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"routing":"<string>"}'
```

### validate_swift_code

Validate a SWIFT code and retrieve bank details if valid. Returns validation status and bank information for valid codes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `swift` | string | Yes | SWIFT/BIC code to validate (e.g. 'CHASUS33', 'BARCGB22'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-theswiftcodes-com-api-ac6a3ab7/validate_swift_code \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"swift":"<string>"}'
```