# Theswiftcodes — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/get-all-countries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/get-featured-banks-by-country \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/get-swift-code-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/get-swift-codes-by-bank \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/get-swift-codes-by-country \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/search-swift-codes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/validate-iban \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/validate-routing-number \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/theswiftcodes/validate-swift-code \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"swift":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.