---
title: SWIFT/BIC Code Finder API Reference
version: 1.0.0
description: Progressively drill down from all supported countries to a specific bank's SWIFT/BIC codes. With no parameters, returns the list of all supported countries. Adding country returns the list of bank names in that country. Adding bank returns the list of cities that bank operates in. Adding city as well returns the matching SWIFT/BIC codes. Parameters must be supplied in order (country, then bank, then city) — supplying bank without country, for example, returns a 400. An unmatched country/bank/city combination returns a 200 with an empty array, not an error.
openapi: 3.1.1
servers:
  - https://api.apifreaks.com/v1.0
paths: 1
operations: 1
schemas: 3
---

## Table of Contents

- [SWIFT/BIC Code Finder API Reference v1.0.0](#swiftbic-code-finder-api-reference-v100)
  - [Authentication](#authentication)
  - [Financial APIs](#financial-apis)
    - [findSwiftCode](#findswiftcode)
      - [Parameters](#parameters)
      - [Responses](#responses)
  - [Schemas](#schemas)
    - [SwiftCodeFinderResponse](#swiftcodefinderresponse)
    - [SwiftCodeString](#swiftcodestring)
    - [ErrorResponse](#errorresponse)



# SWIFT/BIC Code Finder API Reference v1.0.0

Progressively drill down from all supported countries to a specific bank's SWIFT/BIC codes. With no parameters, returns the list of all supported countries. Adding country returns the list of bank names in that country. Adding bank returns the list of cities that bank operates in. Adding city as well returns the matching SWIFT/BIC codes. Parameters must be supplied in order (country, then bank, then city) — supplying bank without country, for example, returns a 400. An unmatched country/bank/city combination returns a 200 with an empty array, not an error.

Base URLs:

* [https://api.apifreaks.com/v1.0](https://api.apifreaks.com/v1.0)

## Authentication

* API Key (ApiKeyAuthHeader)
    - Parameter Name: **X-apiKey**, in: header. Pass your API key via the X-apiKey request header.

* API Key (ApiKeyAuthQuery)
    - Parameter Name: **apiKey**, in: query. Pass your API key via the apiKey query parameter.

## Financial APIs

### findSwiftCode

`GET /swift-code/finder`

*Find SWIFT codes*

Drills down from countries to banks to cities to SWIFT/BIC codes, one parameter level at a time.

#### Parameters

|Name|In|Type|Required|Description|
|---|---|---|---|---|
|format|query|string|false|Specify the desired response format. Options: 'json' (default) or 'xml'.|
|country|query|string|false|Country name (accepts full name, e.g., Pakistan, United States). If supplied alone, returns the list of bank names in that country. If omitted entirely, returns the list of all supported countries.|
|bank|query|string|false|Bank name (upper case) to drill into. Requires country to also be set. If supplied without city, returns the list of cities that bank operates in.|
|city|query|string|false|City (upper case) to narrow results to. Requires country and bank to also be set. Returns the matching SWIFT/BIC codes for that bank in that city.|

##### Enumerated Values

|Parameter|Value|
|---|---|
|format|json|
|format|xml|

> Example responses

> Successful response. The array's contents depend on which parameters were supplied — see the examples for each drill-down level.

```json
[
  "Albania",
  "Algeria",
  "Andorra",
  "Germany",
  "United States"
]
```

```json
[
  "1NCE GMBH",
  "AAREAL BANK AG",
  "DEUTSCHE BANK AG"
]
```

```json
[
  "AACHEN",
  "BERLIN",
  "FRANKFURT AM MAIN",
  "MUENCHEN"
]
```

```json
[
  "DEUTDEBB101",
  "DEUTDEBB162",
  "DEUTDEBB165",
  "DEUTDEBBXXX",
  "DEUTDEDB101"
]
```

```json
[]
```

> Bad Request — Parameters supplied out of order

```json
{
  "message": "Invalid query parameters. Provide parameters in sequence: country → bank → city"
}
```

#### Responses

|Status|Meaning|Description|Schema|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|Successful response. The array's contents depend on which parameters were supplied — see the examples for each drill-down level.|[SwiftCodeFinderResponse](#swiftcodefinderresponse)|
|400|[Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1)|Bad Request — Parameters supplied out of order|[ErrorResponse](#errorresponse)|

#### Response Headers

|Status|Header|Type|Format|Description|
|---|---|---|---|---|
|200|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|
|400|X-AF-Credits-Cost|integer||Specifies the number of credits consumed by the current request.|

To perform this operation, you must be authenticated by means of one of the following methods:
ApiKeyAuthHeader, ApiKeyAuthQuery

## Schemas

### SwiftCodeFinderResponse

Array of strings whose meaning depends on the supplied parameters: country names, bank names, city names, or SWIFT/BIC codes.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|*anonymous*|[[SwiftCodeString](#swiftcodestring)]|false|none|Array of strings whose meaning depends on the supplied parameters: country names, bank names, city names, or SWIFT/BIC codes.|

### SwiftCodeString

A single result value — a country name, bank name, city name, or SWIFT/BIC code depending on the drill-down level.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|*anonymous*|string|false|none|A single result value — a country name, bank name, city name, or SWIFT/BIC code depending on the drill-down level.|

### ErrorResponse

Standard error envelope returned by the API on failed requests.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|error|string|false|none|Short error category or exception type.|
|message|string|true|none|Human-readable error message describing the failure.|
|path|string|false|none|API endpoint path that produced the error.|
|status|integer|false|none|HTTP status code returned with the error.|
|timestamp|string(date-time)|false|none|Timestamp when the error occurred (ISO 8601).|