---
title: SWIFT/BIC Code API - Look Up Bank Details or Find Codes by Country, Bank & City
version: 1.0.0
description: Look up a SWIFT/BIC code to retrieve bank details. Returns the bank name, address, city, country, country code, and bank code for any valid 8 or 11 character SWIFT/BIC code. Supports both headquarters and branch-level SWIFT codes.
openapi: 3.1.1
servers:
  - https://api.apifreaks.com/v1.0
paths: 1
operations: 1
schemas: 2
---

## Table of Contents

- [SWIFT/BIC Code API - Look Up Bank Details or Find Codes by Country, Bank & City v1.0.0](#swiftbic-code-api-look-up-bank-details-or-find-codes-by-country-bank-city-v100)
  - [Authentication](#authentication)
  - [Financial APIs](#financial-apis)
    - [lookupSwiftCode](#lookupswiftcode)
      - [Parameters](#parameters)
      - [Responses](#responses)
  - [Schemas](#schemas)
    - [SwiftCodeLookup](#swiftcodelookup)
    - [ErrorResponse](#errorresponse)



# SWIFT/BIC Code API - Look Up Bank Details or Find Codes by Country, Bank & City v1.0.0

Look up a SWIFT/BIC code to retrieve bank details. Returns the bank name, address, city, country, country code, and bank code for any valid 8 or 11 character SWIFT/BIC code. Supports both headquarters and branch-level SWIFT codes.

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

### lookupSwiftCode

`GET /swift-code/lookup`

*Lookup SWIFT code details*

Fetches detailed information about a SWIFT code.

#### Parameters

|Name|In|Type|Required|Description|
|---|---|---|---|---|
|format|query|string|false|Specify the desired response format. Options: 'json' (default) or 'xml'.|
|swiftCode|query|string|true|SWIFT/BIC code to lookup (must be 8 or 11 characters).|

##### Enumerated Values

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

> Example responses

> Successful response

```json
{
  "swiftCode": "NWBKGB2LXXX",
  "countryCode": "GB",
  "bankAddress": "250 BISHOPSGATE",
  "bankCode": "NWBK",
  "bankName": "NATIONAL WESTMINSTER BANK PLC",
  "city": "LONDON",
  "country": "United Kingdom"
}
```

> Bad Request

```json
{
  "error": "Invalid Param Exception",
  "message": "please pass correct parameters",
  "path": "/v1.0/swift-code/lookup",
  "status": 400,
  "timestamp": "2026-07-27T11:50:49.650Z"
}
```

```json
{
  "message": "Bad request: SWIFT code input must be either 8 characters or 11 characters"
}
```

> Not Found

```json
{
  "message": "No bank found with the provided SWIFT code"
}
```

#### Responses

|Status|Meaning|Description|Schema|
|---|---|---|---|
|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|Successful response|[SwiftCodeLookup](#swiftcodelookup)|
|400|[Bad Request](https://tools.ietf.org/html/rfc7231#section-6.5.1)|Bad Request|[ErrorResponse](#errorresponse)|
|404|[Not Found](https://tools.ietf.org/html/rfc7231#section-6.5.4)|Not Found|[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.|
|404|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

### SwiftCodeLookup

Bank details returned for a SWIFT/BIC code lookup.

#### Properties

|Name|Type|Required|Restrictions|Description|
|---|---|---|---|---|
|swiftCode|string|true|none|SWIFT/BIC code, normalized to its 11-character form (an 8-character input is returned padded with XXX).|
|countryCode|string|true|none|ISO 3166-1 alpha-2 country code where the bank is registered.|
|bankAddress|string|true|none|Physical address of the bank branch.|
|bankCode|string|true|none|Bank code portion of the SWIFT code (first 4 characters).|
|bankName|string|true|none|Full name of the bank or financial institution.|
|city|string|true|none|City where the bank branch is located.|
|country|string|true|none|Full country name where the bank is registered.|

### 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).|