> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.
# BIC検証
> `bic`エンドポイントはビジネス識別コード（BIC）を検証し、国際銀行業務向けに銀行コード、国情報、機関タイプの詳細な内訳を提供します。
## はじめに
### ベースURL
```
https://bankvalidation.cleariflow.com/v1/bic/
```
### 検証エンドポイント
`bic`エンドポイントには、APIキーとBICパラメータが必要です。ビジネス識別コード（BIC）の包括的な検証を行います。
```
https://bankvalidation.cleariflow.com/v1/bic/
? api_key = YOUR_UNIQUE_API_KEY
& bic = DEUTDEFF500
```
この成功したリクエストは、ドイツのBICを検証し、詳細情報を返します。
```json theme={"system"}
{
"bic": "DEUTDEFF500",
"is_valid": true,
"country_code": "DE",
"country_name": "Germany",
"bank_code": "DEUT",
"bank_name": "Bank information not available",
"location_code": "F",
"branch_code": "500",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### リクエストパラメータ
固有のAPIキーです。各ユーザーはCleariflowの各APIごとに固有のAPIキーを持っているため、銀行検証APIのキーは為替レートAPIなどでは動作しません。
検証するビジネス識別コード（BIC）です。スペースは許可され、処理中に自動的に削除されます。BICはISO 9362標準フォーマットに従う必要があります。
### レスポンスパラメータ
APIレスポンスは、汎用的で軽量な [JSON形式](https://www.json.org/json-en.html) で返されます。
スペースを除いた正規化されたBICで、大文字形式で返されます。
すべての検証ルールに従ってBICが有効かどうかを示す総合的な検証結果です。
2文字のISO国コードです（例：ドイツはDE、米国はUS）。
BICに関連する国の正式名称です。
4文字の銀行識別コードです（例：ドイツ銀行はDEUT）。
The name of the bank (currently shows "Bank information not available").
都市または地域を示す2文字のロケーションコードです（例：フランクフルトはFF）。
3文字の支店コードです（オプション、8文字BICでは空の場合があります）。
BICのタイプとステータスに関する追加の詳細情報です。
識別子のタイプです（通常は「BIC」）。
BICが現在有効で使用中かどうかです。
金融機関のタイプです（例：「Bank」「Credit Union」）。
## 例
### 有効なドイツのBIC（8文字）
**リクエスト：**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF
```
**レスポンス：**
```json theme={"system"}
{
"bic": "DEUTDEFF",
"is_valid": true,
"country_code": "DE",
"country_name": "Germany",
"bank_code": "DEUT",
"bank_name": "Bank information not available",
"location_code": "FF",
"branch_code": "",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### 有効なドイツのBIC（支店付き11文字）
**リクエスト：**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF500
```
**レスポンス：**
```json theme={"system"}
{
"bic": "DEUTDEFF500",
"is_valid": true,
"country_code": "DE",
"country_name": "Germany",
"bank_code": "DEUT",
"bank_name": "Bank information not available",
"location_code": "FF",
"branch_code": "500",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### 有効な米国のBIC
**リクエスト：**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=CHASUS33
```
**レスポンス：**
```json theme={"system"}
{
"bic": "CHASUS33",
"is_valid": true,
"country_code": "US",
"country_name": "United States",
"bank_code": "CHAS",
"bank_name": "Bank information not available",
"location_code": "33",
"branch_code": "",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### 有効な英国のBIC
**リクエスト：**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=NWBKGB2L
```
**レスポンス：**
```json theme={"system"}
{
"bic": "NWBKGB2L",
"is_valid": true,
"country_code": "GB",
"country_name": "United Kingdom",
"bank_code": "NWBK",
"bank_name": "Bank information not available",
"location_code": "2L",
"branch_code": "",
"details": {
"type": "BIC",
"active": true,
"institution_type": "Bank"
}
}
```
### 無効なBIC
**リクエスト：**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=INVALID
```
**レスポンス：**
```json theme={"system"}
{
"bic": "INVALID",
"is_valid": false,
"country_code": "",
"country_name": "",
"bank_code": "",
"bank_name": "Bank information not available",
"location_code": "",
"branch_code": "",
"details": {
"type": "BIC",
"active": true
}
}
```
## エラーハンドリング
### BICパラメータの欠落
**リクエスト：**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY
```
**レスポンス：**
```json theme={"system"}
{
"error": {
"message": "Missing bic",
"code": "missing_bic"
}
}
```
### APIキーの欠落
**リクエスト：**
```
GET https://bankvalidation.cleariflow.com/v1/bic/?bic=DEUTDEFF500
```
**レスポンス：**
```json theme={"system"}
{
"error": {
"message": "API key is required",
"code": "missing_api_key"
}
}
```
## BICの構造
BICはいくつかのコンポーネントで構成されます：
1. **銀行コード（4文字）**：金融機関の固有識別子
2. **国コード（2文字）**：ISO 3166-1 alpha-2国コード
3. **ロケーションコード（2文字）**：都市または地域の識別子
4. **支店コード（3文字）**：オプションの支店識別子（本店はXXX）
### フォーマット例
* **8文字BIC**：`DEUTDEFF`（ドイツ銀行、ドイツ、フランクフルト）
* **11文字BIC**：`DEUTDEFF500`（ドイツ銀行、ドイツ、フランクフルト、支店500）
### 一般的なロケーションコード
* **FF**：ドイツ・フランクフルト
* **33**：米国・ニューヨーク
* **2L**：イギリス・ロンドン
* **PP**：フランス・パリ
* **MM**：イタリア・ミラノ
## 検証ルール
APIは次を含む包括的な検証を実行します：
1. **長さの検証**：BICが8文字または11文字か確認
2. **フォーマット検証**：BICがISO 9362標準に従っているか確認
3. **文字検証**：英数字のみが使用されていることを確認
4. **国コード検証**：国コードのフォーマットを検証
5. **銀行コード検証**：銀行識別子のフォーマットを確認
### BICフォーマット要件
* **銀行コード**：4文字の英数字
* **国コード**：2文字のアルファベット（ISO 3166-1）
* **ロケーションコード**：2文字の英数字
* **支店コード**：3文字の英数字（オプション）
## BICとSWIFT
BIC (Business Identifier Code) and SWIFT are often used interchangeably:
* **BIC**：公式のISO 9362標準名
* **SWIFT**：このコードを普及させたメッセージングネットワーク
* **SWIFTコード**：BICの別名
すべてのBICはSWIFTメッセージングに使用できますが、すべてのSWIFTコードが有効なBICであるとは限りません。
## サポート対象国
APIは50か国以上のBIC検証をサポートしており、以下を含みます：
* **ヨーロッパ**：ドイツ、フランス、イタリア、スペイン、オランダ、ベルギー、オーストリア、スイス、英国、ポーランド
* **アメリカ大陸**：米国、カナダ、ブラジル、メキシコ
* **アジア**：日本、シンガポール、香港、オーストラリア
* **アフリカ**：南アフリカ、エジプト、ナイジェリア
サポート対象国の完全なリストは [サポート対象国](/bank-validation/countries) ページを参照してください。
## ユースケース
BIC検証は次の用途で不可欠です：
1. **国際送金**：正確なルーティング情報の確保
2. **SEPA決済**：欧州決済システムの要件
3. **銀行アプリケーション**：顧客口座の検証
4. **金融コンプライアンス**：規制報告要件
5. **決済処理**：eコマースおよびフィンテックアプリケーション